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FOREWORD 


This report presents the results of the project to design an automatic 
system for computer program documentation. This work was performed by the 
Texas Engineering Experiment Station at Texas A&M University, College Station, 
Texas. This work was performed under Contract NAS5-1 1911 for the National 
Aeronautics and Space Administration, Goddard Space Flight Center, Greenbelt, 
Maryland. The project monitor was Mr. E. P. Damon. 

The authors wish to express their appreciation for the assistance provided 
by Randy Birge, Hank Goggan, Melvin McKinney, George Nichols, Ralph F. Planthold, 
Charles Schroeder, Andrew Sobey, Jr., Ernest R. Story, James R. Thames, and 
Darrell Ward. 

This report was submitted on December 15, 1972. 



ABSTRACT 


This report describes the work done on a project to design an automatic 
system for computer program documentation. An extensive survey of documentation 
aids was made to determine what existing programs could be used effectively 
to document computer programs. Results of the study are included in the form 
of an extensive bibliography and working papers on appropriate operating systems, 
text editors, program editors, data structures, standards, decision tables, 
flowchart systems, and proprietary documentation aids. The preliminary design 
for an automated documentation system is included. An actual program has been 
documented in detail to demonstrate the types of output that can be produced 
by the proposed system. 
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1.0 INTRODUCTION 

Program documentation consists of all those items produced to help some- 
one understand a program but which are not actually needed to produce the 
program. A program listing, when properly prepared, contains much descriptive 
information in addition to what is necessary to create the program. Documents 
such as written program descriptions, two dimensional data layouts, flowcharts, 
and cross references are all part of program documentation. 

There is ample evidence that indicates the programmers, when properly 
motivated, are more than willing to provide needed program documentation. 

The problem of documentation is less one of ability to document than it is to 
define realistic documentation requirements. And, it is a general misconcep- 
tion that most programmers prefer to do things in their own way instead of in a 
standard way. Programmers are quite willing to follow a prescription for 
documentation as long as the policy is sound. A realistic management policy 
makes the difference between good and poor documentation. 

To be generally useful, an automatic system for computer program documen- 
tation should document programs written in compiler or assembler languages. 

It should be independent of any manufacturer's computer or peripheral equipment. 
It should be applicable to a wide variety of types and sizes of programs. And, 
it should be capable of providing complete documentation for large, comp lex. 
high-use programs and more elementary documentation for smaller low-usage 
programs. 

Such a system will be described in the following section. In general, 
documentation will be derived from information programmers normally supply when 
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designing, programming, and debugging a program. The system is both economical 
to operate and easy to use. The automated system described in this report 
allows a manager to specify the type and degree of documentation he would like 
produced on a project. The system aids him in controlling programming projects 
during development. Documentation produced by the system has been designed 
with flexibility to meet the needs of various types of programming projects. 

The development of the automated documentation system design was accomplished 
over a period of nine months. During the first part of the study existing documen- 
tation aids were surveyed and their effectiveness was evaluated. An extensive 
bibliography of documentation aids was developed which is included in Appendix 
A of this report. To aid in evaluating documentation aids, working reports in 
areas such as program editors, text editors, operating systems, proprietary 
systems, flowcharting systems, and decision tables were produced. Existing 
documentation standards were examined. Audio-documentation techniques were 
explored as a possible alternative to written documentation. 

Upon completion of the study and evaluation phase, an automatic documenta- 
tion system was designed. One major objective of the system was to include 
existing documentation aids whenever possible. The system has been designed to 
make maximum use of existing software and to minimize the amount of additional 
software that needs to be developed in order to have an efficient, easy-to- 
operate, user-oriented automated documentation system. The system produces 
documentation during the development of a project as well as final documentation 
needed to understand and maintain the programming system. 

In the following section the documentation aids study and evaluation phase 
will be described in detail. Then an overview of the system design will be 
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given after which a sample output from the proposed system will be described. 

A section describing the deliverable items described in the original contract 
is included after the sample program. 

2.0 DOCUMENTATION AIDS - STUDY AND EVALUATION 

An extensive study of existing documentation aids was made. Computer 
abstracts, relevant computer literature, and government information services 
were used to locate pertinent documents. A key word in context (KWIC) program 
was used to produce the bibliography contained in Appendix A. The bibliography 
cites 149 documents. In the first section of the bibliography, documents are 
listed by author. Each entry contains the author's name, the title of the 
document and the document number. In the next section, the document titles 
are listed according to key word with the document number to reference the 
full entry in the next section. In the third section of the bibliography, 
each document entered in the bibliography is listed by document number. The 
complete entry contains the name of the author, title, source of the reference 
and a brief statement about the contents of the reference. The last section 
of the bibliography is the KWIC index of document titles. 

In addition to surveying existing literature and government data bases, 
a number of documentation aids which are supplied commercially were examined. 

A working paper was written describing AUTOCHART, AUTODIAGRAMMER, AUTODOC, 
AUTOFLOW, COMCHART, DYNACHART, EASY FLOW, FACTS, FLOWGEN/F, F0RFL0, QUICKDRAW, 
SUPEREF, and F0RD0C. All of the existing documentation aids had obvious fail- 
ings. Many were restricted to either a single language or a single machine. None 
produced all of the documentation required to document a computer program. Most 
were able to document only at compilation level in contrast to a load module level 
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or a total system level. Many were limited to a single output device. Existing 
documentation aids are as difficult to use as a major compiler. If the 
programmer were to make use of more than one proprietary documentation aid 
he would have to make a major effort to learn the detailed rules of each 
package. Even though proprietary systems are quite expensive, they do not 
meet the total documentation needs of a major computer user in that most do not 
even address themselves to the problems of dealing with the textual descriptions, 
data layouts, etc., that must be included in every set of documentation. 

While NASA has computers from almost every computer manufacturer, a major 
part of program development is done on IBM, CDC, and Uni vac systems. A 
working paper contained in Appendix C describes options available to the 
user through compilers, assemblers, and linkage editor/loaders. The operating 
systems evaluated were IBM's 0S/360, Univac's EXEC 8, and CDC's SC0PE3. The 
languages chosen for study to determine options available were PL/1, FORTRAN, 
COBOL, and the Assembly language appropriate for the specific machine. 

In the design of the automated documentation system, a decision was made 
not to modify any compiler or operating system. All information required for 
documentation would be either obtained from output normally produced by the 
appropriate software or from a special program produced to recreate the in- 
formation. While the operating systems developed for the different machines 
are not the same, many options are very similar. An automatic documentation 
system that is designed to be used on any of the machines should take advantage 
of the common options of the operating systems. Tables within the working 
paper on operating systems describe the options of the systems and show which 
options are similar for the various operating systems. 
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Audio techniques were examined to determine their effectiveness as a 
tool for documentation. An experiment described in Appendix D was conducted 
in which programs were documented using both written and audio techniques. 

No significant advantage to either mode of documentation was noted. Probably 
the most useful place for audio recording techniques would be in the capturing 
of information which is later transcribed to written text. Many programmers 
who do not like to write descriptions of programming systems are perfectly 
willing to dictate them into a recorder. The recorder description can then 
be transcribed and edited into high quality written descriptions of programs. 

Since much of the final documentation of programming systems is written 
text, text editors must be considered a major documentation aid. Many text 
editors such as the interactive ATS text editor on the IBM 360/370 or the 
batch TEXT360 available on the same systems required many man years to develop. 
Systems such as text editors should be used as subsystems of any automated 
documentation system developed so that it is not necessary to reproduce the 
features already built into existing text editors. Appendix E is a working 
paper describing text editors. Included are APL Text Editor, MTST, ASTR0C0MP, 
DATATEXT, EDIT, ED PROCESSOR, ATS, TEXT/360, HES, FRESS, REDIT/RUNOFF, NLS, (TNLS, 
DNLS) and TEXT. Included in the Appendix are descriptions of the various systems 
and a table comparing them. Some of these text editors would be excellent 
subsystems of an automated documentation system. 

Program editors were also examined during the study and evaluation phase. 

In Appendix F the CMS, WYLBUR, QED, TECO, TVEDIT, EDIT, and ED on-line program 
editors were compared. Also the LIBRARIAN, SIMPLE, CLOT, PROG RAM/ MAN AGE, CFMS, 
PANVALET, PLUS D-A, SPLIS-II, IEBUPDAT, IEBUPDTE, and ED off-line program 
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editors were described and compared. Program editors are not as complex as 
text editors, and most of the features of the program editors are included 
as subsets of the features of text editors. The program editor function 
would be developed as a part of the software necessary to control an automated 
documentation system that encompasses a wide spectrum of documentation aids. 

A report was written by George C. Nichols describing a number of exist- 
ing flowcharting systems.* A number of articles have been published on the 
various flowcharting systems. The most comprehensive comparison of flowchart- 
ing systems was written by Ned Chapin. ** N. Chapin mentions in his book 
that of the flowcharting systems he has evaluated, none could draw the standard 
flowchart symbols recommended by the American Standard Association. A system 
developed by D. B. Simmons at Bell Telephone Laboratories is operational and 
can draw any flowchart symbol on any type of output device to document any 
language. A number of flowcharting systems exist which could be driven by 
an automatic documentation system. 

Decision tables are sometimes used as a type of documentation. Sometimes 
the actual source program is automatically produced from a type of decision 
table. An evaluation of existing decision table systems was done by J. R. 
Thames.*** In most cases, decision tables are used to produce a program 
instead of vice versa. It is felt that for most programming languages, it 
is not appropriate to automatically produce decision tables from source codes. 


* Automatic documentation: A State of The Art Report by George C. Nichols 
written in partial fulfillment of a Master of Science degree in Computer 
Science 

** Chapin, N., Flowcharts , Auerbach Publishers, Princeton, 1971 

*** J. R. Thames7 ~5ocumentation : Justification and Decision Table Exemplification , 
Texas A&M University, Spring, 1972 prepared in partial fulfillment of 
requirements for the degree of Master of Computing Science. 
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In most programming languages, the data description is either implicitly 
or explicitly described in a linear manner. When someone works with a complex 
data structure, special documentation techniques such as a two dimensional 
description of a data structure is useful. At the present time, very little 
has been done to automatically document data structures of programs. A 
short report was written and is included in Appendix G describing characteristics 
of the data structures of the PL/1, FORTRAN, and COBOL languages. Additional 
work needs to be done in the area of automatically describing data structures. 

A very important facet of program documentation involves the standards 
that are used. There is no set of standards for all documentation that is 
produced describing programs. Standards exist for flowcharts but in other 
areas there are no generally accepted standards, and local practices usually 
take their place. A number of local documentation standards from both 
government and industry were examined and a short report on documentation 
standards is included in Appendix H. 

As a result of the study evaluation phase, it was determined that many 
of the existing software systems such as text editors, flowcharters, language 
processors, operating systems, and data description software can be used as 
modules of a total documentation system. A flexible user-oriented documenta- 
tion system is described in the following section. 

3.0 AUTOMATIC SYSTEM FOR COMPUTER PROGRAM DOCUMENTATION 

An automatic documentation system has been designed to produce timely 
up-to-date documentation at a relatively low co§t. The system will document 
any computer language and run on any hardware taking advantage of existing 
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documentation aids. The system will be easy to use and will place no 
restrictions on the programmer. A detailed proposal for implementing the 
automatic documentation system is included in Appendix I. A brief summary 
of the system features is given in the next section. 

3.1 System Features 

The automatic documentation system will have the following features: 

1. Minimal programmer restrictions - The system will be able to 
produce detailed, detail -suppressed and global flowcharts, data 
layouts, overlay descriptions, special cross reference glossaries, 
etc., from any computer program. Programmers who write comnents 
in a standard way and who write their program descriptions using 
an interactive interrogator will be able to produce all documenta- 
tion automatically. The system will be designed so that if a 
program is developed outside the system it will be fairly easy to 
retrofit the program into the system for documentation maintenance. 

2. Eliminate all redundant efforts - Documentation produced in an early 
phase of the design or implementation process can be reused later 

on in the development process. 

3. No operating system modification - No modifications will be made to 
any operating system. Items of documentation interest will be obtained 
by scanning output produced by operating systems or by reproducing 
information found in the internal tables of the operating system. 
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4. Use of existing documentation aids - Existing documentation aids will 
be used as modules in the comprehensive automated system. 

5. Interactive/batch system - An interactive mode with special features 
for interrogating the user of the system will be used to obtain 
necessary documentation aids. An alternative batch mode will be 
available. 

6. Documentation during development - The documentation data base will 
be constructed from information gathered during all design phases. 

As the design progresses, the user supplies only the information not 
available from previous steps. 

7. Accept any language - The automated documentation system will be 
language independent. Initially the system will be designed to accept 
FORTRAN, COBOL, PL/1, and Assembly Language. 

8. Operate on any hardware - Initially the system will be designed to 
operate on the IBM 360 with planned expansion to the Uni vac 1108 
and the CDC 6600 computer systems. 

9. Monitor and control projects - Features will be designed into the 
system to allow the project manager to monitor the exact status of 
program development and program documentation. In addition, system 
access and security will be under his control. 

3.2 Initial Phase 

It is proposed that in January, 1973, initial development of the automatic 
system for computer program documentation will begin. A twelve month peridd be- 
ginning at that time will be termed the initial phase-; During the initial phase 
either FORTRAN or: COBOL will be used toiwrite programs that make up the automatic 
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documentation system. Initial development will be for a system operational on 
an IBM 360 computer*, but software will be easily transportable to the Univac 
or CDC system. The automatic documentation system will document COBOL, FORTRAN, 
PL/1, or assembler language programs. 

A detailed description of how the automated documentation system can be 
used for documentation during development as well as for documentation when 
development is complete is described in the proposal contained in Appendix I. 

3.3 System Structure 

Three types of programs will be used in the system. Types 1 and 2 are 
new programs that must be developed. Type 3 programs are existing programs 
that can be used without change. Type 3 programs make up a major part of 
the software necessary to implement the automatic documentation system. New 
programs will not be developed when operational documentation aids are available. 
By doing this, a sophisticated system will be developed at a relatively low 
cost. A detailed description of the Type 1, Type 2, and Type 3 programs is 
contained in Appendix I. The detailed descriptions of the programs to be 
developed and the types of documentation produced by the system are described 
in Appendix I. 

3.4 Advantages 

Use of the proposed automatic documentation system offers many advantages 
over other techniques for developing programs and producing documentation. 

The system will be user-oriented and will be as easy to operate as existing 
on-line or batch program editors. Programmers who use good programming 
practices in developing software can use all of the system features without 
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extra effort. Programmer productivity will be enhanced by improved communica- 
tions during the development process. A modular system will allow new types 
of documentation to be easily added to the system. This is the first system to 
bring together all types of documentation aids into a single system. It 
emphasizes documentation on a load module and system basis as well as for 
a single compilation. Documents can be produced containing heterogeneous 
outputs such as text and flowcharts. Managers can use the system to control 
and monitor projects. Program and documentation standards can be enforced 
and taught through the use of automatic documentation systems. People who 
do not use the documentation system during program development will be able 
to use it for post-development documentation. Programs developed independently 
of the automatic documentation system can easily be retrofited into the 
documentation data base. 

4.0 SAMPLE PROGRAM DOCUMENTATION 

A sample of the types of documentation to be produced by the automatic 
system is included in Appendix J. Since the types and formats of the documen- 
tation prepared is completely determined by the user when he specifies templates 
for data to be collected and the recipes for documentation to be produced, the 
sample is just one possible format that a manager could select. The templates 
and recipes can be varied from one project to the other. 

The subject of the sample documentation was a set of fifteen Fortran 
programs called "DYNASOR-II, A Finite Element Program for the Dynamic Nonlinear 
Analysis of Shells of Revolution" developed for NASA by Joe R. Tillerson and 
Walter E. Haisler of the Aerospace Engineering Department, Texas A&M University. 
The DYNASOR II programs were developed to compute the nonlinear dynamic response 
of shells of revolution in relatively short periods of computer time for a 
large number of important shell problems. 
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The sample documentation for the DYNASOR II system is in three parts, a 
User's Manual, a Program Maintenance Manual and an Operations Manual. These 
manuals bring together information generated in various stages of the develop- 
ment process by such people as the specifier, designer, programmer and the 
validator*. The sample documentation shows how the same information can be 
used to produce documentation for the system user, maintainer or operator. 

The sample User's Manual is designed to explain to a scientist or engineer 
the problem solution and to show him how to prepare input to use the programs. 

It is prepared assuming that the user does not know computer programming. 

The User's Manual begins with a title page, abstract, system overview, 

system flowcharts, and environment and configuration descriptions. These 
components can also be used without change in the maintenance and operator 

guides. The User's Manual then describes the method of analysis of the 
problem. Included next are guidelines for the user and program limitations. 

The next section covers the meaning of the input parameters and how to prepare 
the Input. The solution of example problems using DYNASOR II are included 
to further clarify the system for the user. A list of references to the 
methods of analysis is given in case the user would like to study the techniques 
in detail. A special restart feature of the DYNASOR II program is explained 
in addition to a discussion on how to properly choose certain input parameters 
(in this case loads and temperatures) for best results. Functional flowcharts 
are included for the user interested in the structure of the programs, their 
functions and how they work together. 

The Maintenance Manual is designed to familiarize the maintenance pro- 
grammer with the set of DYNASOR II programs and to serve as his reference when 
modifying or correcting the programs. The maintenance manual is introduced 
by the title page, abstract, system overview, system flowchart and environment 
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description. The next sections contain detailed descriptions of the computer 
aspects of software being documented on system, global and local levels. On 
the system level there is a subroutine connectivity diagram, a system flowchart, 
and Job Control Language and deck setup descriptions. On the global level, 
overlay maps, global flowcharts, global data descriptions, control card 
descriptions and subroutine calls are included. On the local level, the 
Maintenance Manual contains detailed, detail suppressed, and functional flow- 
charts; local data descriptions; label cross references and individual program 
listings. Also included are system test samples and evaluation criteria. 

Other sections could be included here concerning such items as rules for program- 
ming practices, naming conventions, mathematical symbols and the like. 

The Operator's Manual is designed to be used by the person who is 
responsible for running of the system on the computer. He is not required 
to have a knowledge of the scientific problem or of computer programming. 

Again the manual begins with title page, abstract, system overview, 
system flowchart, and environment page duplicated automatically by the doc- 
umentation system. The next sections describe components of the operation 
of the DYNASOR II runs. The purpose of each run is described along with its 
relationship to other runs, set up and run instructions, run frequency, run 
prerequisites, controls and schedules. Each data set is described along 
with the file characteristics. The job control language and control formats 
are detailed along with directions for setting up the deck. 

Error messages are listed with explanations and actions to be taken. 

There is a section on checkpoint, restart, error procedures, backup and 
recovery procedures. 

Any of the parts of any of the manuals in Appendix J can be produced 
separately at any stage of development where appropriate data is available 
in the data base. 
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5.0 DELIVERABLE ITEMS 

Article II of NASA Contract NAS5-1 1911 requested the following deliverable 
items: 

a) Items of interest for documentation purposes that can be obtained 
automatically by the use of specifically designed computer programs 
and/or modifications to the operating system and associated software . 
Output that can be obtained from commerical documentation aids is 
described In Appendix B. Text editors are described in Appendix C 
and program editors are described in Appendix F. No modifications 

to operating systems or associated software are recommended. Items 
of interest for documentation purposes that can be obtained auto- 
matically by the proposed automatic documentation system are described 
in Appendix I. 

b) Sample formats of useful and alternate printouts applicable to pro- 
gram documentation; derived from (a) . 

Sample outputs of the type of documentation that will be produced 
by the automatic documentation system are included in Appendix J. 

c) Methods by which the necessary data are obtained from source decks 
and/or operating system components (compilers, loaders, etc.). 

A detailed description of the methods by which the necessary data 
are obtained from source decks and/or operating system components 
is described in the Appendix I. 

d) Programming disciplines, restrictions or coding requirements imposed 
upon programmers in order to enable them to produce documentation by 
using software recommended as a result of this effort. 
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The report should indicate what behavior may be expected if required 
disciplines are not observed and obeyed. In establishing these 
constraints, consideration must be given as to what may be reasonably 
expected in the way of programmer cooperation . 

The automatic documentation system will be as easy to use as the typical 
program editor. For programmers who use text editors in developing 
their program descriptions, additional restrictions will not be 
necessary to the textual part of the documentation. A large part 
of the documentation necessary to describe the program can be 
produced with no programmer restrictions as described in Appendix I. 

For such things as high quality functional flowcharts, the programmer 
will be required to stylize his program conments. A program developed 
outside the automatic documentation system can be retrofitted into 
the documentation system. In the design of the automatic documentation 
system, a major effort will be made to minimize restrictions on 
programmers. 

e) Certain of the outputs desirable for program documentation purposes 
may be obtained by modifying standard software components. Inasmuch 
as most compilers, loaders, etc., extract relevant information and 
retain it internally, much of the program development needed to 
produce this data in readable form may be avoided; however, two points 
must be borne in mind. First, this effort is not directed toward 
a specific type or model of computer or software system; hence, the 
techniques employed must be more or less generally applicable. 

Second, it is most desirable that system modifications be kept to a 
minimum; hence, it would be preferable to confine such modifications 












to a few system modules as is practicable and to modularize any 


proposed extensions to the fullest possible extent. 

No standard software components will be modified. 

If one or more specific operating systems are cited as illustrative 
examples, or for purposes of investigation, the particular modules 
or components of the system(s) requiring change, and the nature of 
such changes, should be fully described to the extent that they 
are penetrated by this study. 

No modules or components of operating systems need be changed to 
work with the proposed automatic documentation system. 

While certain information may be extracted by altering system 
components, certain independent programs may be required to complete 
the package in order to supplement, broaden and/or organize meaning- 
ful documentation elements. Such programs must be fully described , 
including inputs required, functions performed, and outputs derived . 
Programs required to complete the package in order to supplement, 
broaden and/or organize meaningful documentation elements are Type 1 
and Type 2 programs described in the proposal in Appendix I. Sample 
output provided by the system is described in Appendix J. 

As a separate document or separate section of the final report, there 
will be a consolidation listing of all those techniques which could 
be implemented without changes in hardware or operating systems . 

As a subset of the above, there will be a designation of complexity 
level for the incorporation into a working program. Those which 
require little or no effort or change in style by the applications 


programmer should be specifically defined. 
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No changes will need to be made to program statements in a working 
program for documentation purposes. Documentation systems might 
make changes to the comment fields in a working program, but this 
will be done in a manner that will not, in any way, affect the 
other statements in operational programs. All noncomment program 
statements will be fully protected during any mode in which the 
program comments are being changed. 

i ) This section should be presented and recommended as an integrated , 
usable package which could be implemented immediately to provide 
a partial solution while further work is being done on the more 
elaborate improvements. 

Commercially available documentation aids that can be used immediately 
are described in Appendix B. The initial phase of the automated 
documentation system to be implemented is described in Appendix I. 
Future elaborations and extensions to the system are also described 

in the proposal in Appendix I. 

j) The outputs produced by the automated methods devised should contribute 
to final program documentation. Techniques should be recommended which 
best present a format for future computer program documentation . 

A sample output of the type that would be produced by the automated 
system has been reproduced in Appendix J. This example demonstrates 
the type of output that would be produced by the system. The specific 
format of the manual desired by a project manager would be determined 
by the project manager. 
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000101 COMMUNICATIONS COMPUTES PSOGP AMM | NG CENTER 

AUTOMATED WEATHER NETWORK 

AUTOMATEO WEATHER 01VISICN, CCPC. TINKER AIR FORCE RASE. 

THIS PAPER DESCRIBES THE AUTOMATED WEATHER NETWORK AND 
MENTIONS SOME SUBROUTINES AND INPUT-OUTPUT HANDLING 
METHODS USED IN THE PROJECT. THIS IS A VERY SPECIALIZED 
PAPER OF LITTLF GENERAL INTEREST. 

000102 CONKLIN, C.F. MEADOW, C.T. 

EVOLUTIONARY SYSTEM FOR DATA PROCESSING, VOLUMES I-IV. 

IBM CENTER FOR EXPLORATUPY STUDIES, ROCKVILLE, MD, 1068 

ESDP IS A PROPOSED SYSTEM WHOSE PURPOSE IS TO ACOU I «E , STORE , 
RETP I E VE • P'JBL I SH, AND OISSEMINATE ALL DOCUMENTATION, EXCLU- 
SIVE OF GRAPHICS FOR A LARGE COMPUTER PROGRAMMING ACTIVITY 
VOLUME I. SYSTEM DESCRIPTION. 

VOLUME II. CONTROL AND USE OF THE SYSTEM 

VOLUME III THE CAINT EXECUTIVE LANGUAGE t INSTR GENERATOR 
VOLUMC IV. PROGRAMMING SPECIFICATIONS 

QCC103 KEIKSTEAO, R.F. PARKER , 0.8. 

ON THE FEASIBILITY OF FORMAL CERTIFICATION 

STANFORD RESEARCH INSTITUTE, MENLO PARK, CALIFORNIA 

THIS PAPER CONSIDERS THE FEASIBILITY OF ESTABLISHING 
CERTIFICATION ANO VALIDATION SERVICES TO ASCERTAIN THE 
RELIABILITY OF SOFTWARE PRODUCTS. 

ODD 10 A CHAPIN, N. 

FLOWCHARTS 

AUERBACH PUBLISHERS,. PRINCETON, 1971 

A COMPREHENSIVE STUDY C* HOW GRAPHIC TECHNIQUES CAN BE USFO 
TO EXPLAIN AND INTERPRET THE COMPLICATED WORKINGS OF A 
COMPUTER. THE BUOK EXPLAINS HOW TO APPLY FLOWCHARTS TO 
ALL PHASES OF DATA PREPARATION ANO PROCESSING. 

58GICI SCOTT, A. F. 

AUTCMATIC PREPARATION OF FLOWCHART LISTING. 

J. ACM S, l ( JAN, 1958 1 , 57-66 

COVERS INITIAL MEANS OF AUTOMATING FLOWCHART PRODUCTION, A 
REASON FOR FLOWCHART PRODUCTION IS TO MAKE IT UNNECESSARY 
TO PUBLISH DETAILED BLCCK DIAGRAMS. AS A DEBUGGING TOOL, 

I T HAS GREAT VALUE . 

590001 HAIBT, L.M. 

A PROGRAM TO DRAW MULTILEVEL FLOWCHARTS 

AFIPS WJCC PROC. 11959), 131-137. 

GENERALLY COVERS THE VARIOUS TYPES OF FLOWCHARTING. 

610601 CANTRELL, H.N. KING, E.E. 

LOGIC STRUCTURE TABLES 

CDMw. ACM MJUNE 1 96 1 1 , 2 72-2 75 

DESCRIBES SET OF RULES FOR WRITING ANO USING LOGIC TABLES. 
LOGIC TABLES ARE TWO-DIMENSIONAL ENABLING ONF TO TULLY 
EXPRESS BOTH SEQUENTIAL AND PARALLEL ASPECTS. THF Y CAN RE 
COMPILED DIRECTLY INTO PROGRAM ELIMINATING NEED F0» 
FLOWCHARTING AND HANO CODING. 
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620901 M')N TALBANO , M. j, 

TABLES, FLOW CHARTS, AND PROGRAM LOGIC l 

IBM SYSTEMS J. I ,9 ( SEPT l«62), 51-63. TO 

DECISIUN TABLES ARE INTRODUCED WITH REFERENCE TO BUSINM* 
DATA PROCESSING. COMPLETENESS ANO CONSISTENCY VERIFICATION 
CHECKS ARE MADE. CONVERSION OF TABLES T'J PPOGPAMS IS 
CONSIDERED AND A TECHNIQUE of OBTAINING A program WHICH 
MINIMIZES BRANCHING REQUIREMENTS WITH RfSPTCT TO MfMORY 
ANO EXECUTION TIMF. DEBUGGING AND MODIFICATION A 3 F ALSO 
DISCUSSED. 

630901 KNUTH, H. E. 

COMPUTER-DRAWN FLOWCHARTS. 

COMM. ACM 6, 9 I SEPT , 1963) . 555-563 

S I M PL E SYSTEM FOR EFFECTIVE COMMUNICATION tS PPESENTFO, 

SUPPOSEDLY HELPS MEET FOR BETTER DOCUMENTATION OF PROGRAMS 
IN SIMPLE FORMAT, COMPUTER PREPARES FLOWCHARTS AND OTHER 
CROSS-REFERENCE LISTING FRO« THIS INPUT. 

631001 IBM CORPORATION 

PROGRAM ENABLES I 3M 7070/7074 TO ORAW FLOWCHARTS. 

E IMPUTE RS AND AUTOMATION 12. 10 (OCT . 196 3) „ 4^ . 

A GENERAL SYSTEM OF FLOWCHARTING. THE COMPUTER PRINTS PUT 
A FLOWCHART. 

640301 SHMIDT, D.T. KAVANAGH, t.e. 

USING DECISION STRUCTURE TABLES 
DATAMATION 10,31 MARCH 1964 1,48 

THIS ARTICLE EMPHASIZES MANUFACTURING APPLICATIONS OF 
DECISION-TABLES. IT ALSU LISTS REASONS WHY DECISION 
TABLES pay OFF. 

640501 MERCER, V. 

AUTOCHART NEW METHUU CUTS MANUFACTURING. 

JOURNAL OF DATA MANAGEMENT 2, 5CMAY, 19641, 644-645. 
COMMERCIAL PROGPAM PACKAGF CAN BE USED TO DECREASE THE COST 
OF PRODUCING PROGRAMS. 

64 ICO l KRIDER, L. 

A FLOW ANALYSIS ALGORITHM 

J. ACM 11, 1D10CT. I 9o4 ) , 429-436. 

ALGEBRAIC REPRESENTATION OF THE F LPW OF A COMPUTER PROGRAM 
IS DESCRIBED. ALGORITHM PRESENTED FOR MANIPULATING This 
R EPRC SFNTAT ION INTO A FORM FROM WHICH f. FLOWCHART CAN PF 
DRAWN. ALSO, A PROCEDURE FUR FORMING Till- ALGfR-AIC 
REPPFSFNTATION FROM A COMPILER SPIJRCF CODE IS GIVEN. 

650101 ANDERSON, H. E. 

AUTOMATED PLOTTING OF FLOWCHARTS ON A SMALL COMPUTER 
COMM. ACM B, 1 ( JAN 1965), 38-39. 

PROGRAM IS DESCRIBED WHICH ACCEPTS FORTRAN II SOURCE PROGRAM 
AS INPUT. PRODUCES ANNOTATED FLOWCHARTS AS "UTP'JT . UNIQUE 
IN THAT A DIGITAL INCREMENTAL PLOTTFR IS USFO AS OUTPUT 
MEDIUM, AND THAT ITS DESIGNED F0° < SMALL (4DK) COMPUTER. 

650102 KIRK, H.W, 

USE (IF DECISION TABLES IN COMPUTER PROGRAMMING 
COMM. ACM 8, H JAN 19651,41-43. 
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ARTICLE 0ESCR10ES DECISION TABLE ADVANTAGES. A TECHNIOIIF 
FCR CONVERSION OF TABLCS TO COMPUTER PROGRAMS IS 
PRESENTED; IT IS THE RULE MASK TECHNIQUE. ADVANTAGES 
GAJNCD THROUGH UTILIZATION OF THE TECHNIQUE ARF ALSO 
OESCR IBEO. 

CONTROL OATA CORPORATION 

CONTROL OATA 6000 SERIES COMPUTER SYSTEMS REFERFNCE MANUAL 
NUMBER 6C 100000 
CONTROL OATA CORPORATION 

THIS MANUAL DESCRIBES THE SVSTEM CHARACTERISTICS OF THF 

6600 SERIES. ALSO DISCUSSED ARE THE CENTRAL MEMORY CENTRAL 
PROCESSOR PERIPHERAL ANO CCNTROL PROCESSORS SYSTEM 
INTERRUPTS ANO MANUAL CONTROL OF THE SYSTEM. 

SNYDER, R. 

PROGRAMMING DOCUMENTATION 
DATAMATION llilOI OCTOBER 19651,44-45 

DOCUMENTATION IS A BY-PRODUCT OF A GOOO SYSTEMS JOB, BUT IT 
IS TVEN MORE IMPORTANT DURING COMPUTER SYSTEM CONVERSION. 

THIS ARTICLE LISTS WHAT GOES INTO AN EFFECTIVE JOB MANUAL. 660403 

POLLACK, S.L. 

CONVERSION OF LIMITED ENTPY DECISION TABLES TO COMPUTER 
PROGRAMS 

CO«M. ACM ft , 1 1 ( NOV 19651 .677-682 

TWO ALGORITHMS ARE PRESENTED FOR CONVERSION OF DECISION 
TABLTS TO COMPUTER PROGRAMS. BOTH ALGORITHMS PINPOINT 
REDUNDANCIES AND CONTRADICTIONS IN THE TABLES. THE FIRST 660631 

ALGORITHM MINIMIZES STORAGE SPACE, THF SECOND MINIMIZFS 
P ON TIME. 

FISHER. D.L. 

OATA, DOCUMENTATION, AND DECISION TABLES 
C.IMM. ACM 9.1IJAN 19661 ,26-31 

IN BUSINESS DATA PROCESSING. IT IS NECESSARY TO BE ABLE TO 

DEFINE AND DOCUMENT DATA, FILES, PROGRAMS AND DECISION 660801 

RULFS IN A WAY THAT REPRESENTS THEIR CHANGING INFORMATION 

format ano their continuous interaction, tables make this 

POSSIBLE. ARTICLE IS BAStCALLY A BUILDUP OF THE VIRTUES OF 
OECISION TABLES. 

VEINOTT, C.G. 

PROGRAMMING OECISION TABLES IN FORTRAN, COBOL OR ALGOL 
COMM. ACM 9 , 1 ( JAN 19661,31-35. 

A BRQAO-BASED APPROACH FOR PROGRAMMING OECISION TABLES IN 

FORTRAN OR COBOL IS DEVELOPED. ONLY ONE OR TWO STATEMFNTS 660901 

ARE DEEMED NECESSARY WITH INPUT IN A STANDARDIZED FORM. 

ACTUAL PROGRAMMING TECHNIQUES ARE OFFERED. THE TECHNIQUES 
ARE ALSO EXTENDED TU ALGOL. 

MARTIN, W. W. 

FLOWCHARTING: SHORTHAND. ANALYSIS AND MODEL. 

JOURNAL OF SYSTEM MANAGEMENT 17, 2 (MARCH-APR 1L , 19661, 14-22 


660301 


660401 


660402 


THIS ARTICLF BEGINS WITH A LIST OF BENEFITS GAINED «Y 
DECISION TABLE UTILIZATION. SOME EXAMPLES OF USAGE APE 
PPRSENTEO. DECISION TABLES ARE DIRECTLY COMPARED TO 
FLOWCHARTS. 

SWANSON, R.W. 

INFORMATION SCIENCES: SOME RESEARCH DIRECTIVES 

NT I S-AD631 5 3 5 

A STUDY OF THE PROCESSES INVOLVED IN IDENTIFYING, 

CLASSIFYING, REPRESENTING, STORING, MANIPULATING, AND 
PRESENTING DATA. 

OPERATIONS DIVISION STRATEGIC SYSTFMS DEPARTMENT 

AUTOMATIC DATA PROCESSING SUPPORT FOR FLAG PLOT 

DDC-ADBl 5567 

THIS REPORT PPCPOSES PRELIMINARY OESIGNS FOR THE FLAG PLOT 
A OP SYSTEMS. IT OUTLINES BOTH HARDWARE AND SOFTWARE PLAN’S 
FOR THF INITIAL ANO INTERMEDIATE EFFORTS IN AUTOMATING 
FLAG PLOT DATA PROCESSING FUNCTIONS. 

BELL SYSTEMS PRACTICES 

PROGRAM OOCUMENTAT ION STANDARDS 

BELL SYSTEMS PRACTICES, AMERICAN TELEPHONE ANO TELFGRAPh ED. 

THIS IS A MANUAL WHICH HAS THF STANDARDS FOP THF BELL SVSTF“ 
IT INCLUDES STANDARDS FOR PROGRAM DOCUMENT AT tCN, 

FLOWCHARTS SYMBULS AND NOTATIONS. OECISION' TABLES ARF 
INCLUDED AS WELL AS NUMEROUS EXAMPLES. 

PEN SI C R 0 , H.S. 

SLIP - SOURCE L I BP ARY INQUIRY PROGRAM, NO. 363P- r D. 3.00® 

HIM CORPORATION, NEW YORK, NY, 1966 

THIS PRE 1 GRAM STORES SYMBOLIC PROGRAM MrT'JL c S "N MAG TAPE AND 
RETRIEVES SELECTED MODULES TO BE LISTEO, PUNCHED, OR 
COPIED TU ANOTHER MAG TAPE ’IN A FORMAT ACCEPTABLE TO Thf 
ASSFMBLER*. IT RUNS ON A S/36 r -3D OR LARGER, UNDER SK OFS. 

REINWALD. L.T. SOLANO, P.M. 

CONVERSION OF L I MI T F O-FNTp v DECISION TAPIES TO OPTI-AL 
COMPUTER PROGRAMS I: MINIMUM AVERAGE PROCESSING T I v t 

J. ACM 13,71 JULY 1966) , 339-T5R. 

BEGINS WITH A BRIEF DESCRIPTION OR DECISION TABLES AND THEN 
PRESENTS A DISCUSSION Or ALTERNATE EXPRESSIONS F0» THEM IN 
THE FURM OF SEQUENTIAL TFSTING PROCEDURES . AN ALC'-KITHM IS 
DEVELOPED FUR CONVERSION OF TABLES TO A PROGRAM WITH 
MINIMUM AVERAGE PROCESSING T!"E. 

HULZER, J.E. 

A SYSTEM OF PROGRAM DOCUMENTATION 

SYSTEMS AND PROCEDURES J. 1 7 , 51 SEPT-OCT 19661,15-17. 

ARTICLE RELATES WHY DOCUMENTATION SHOULO BE USED TO ACHIEVE 
EFFECTIVE COMPUTER UTILIZATION IN AN ORGANIZATION. A 
DFSCRtPTICN OF THE FACETS INVOLVED IN PROGRAM 
DOCUMENTATION IS ALSO P r F S ENTF D. A MANUAL CONTAINING ALL 
PCCUMFNT A T ION IS SUGGESTED. 


SHOAER, J. A • 

DECISION TABLES FOR BERRFP MANAGEMENT SYSTEMS 
SYSTEMS ANO PROCEDURES J. 1 7 , 2 IMARCH-APR I It , 28-32. 


661101 


KING, P.J.M. 

CUN VER S I ON OF DECISION TABLES TO COMPUTER PROGRAMS BY RULF 
MASK TECHNIQUES Is, 


ro 

'nI 
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661101 


COMM. ACM 9 » 11 ( NOV 19661,796-801. 

AR T ICL E PRESENTS A DESCRIPTION OF THE RULE MASK TECHNIQUE 
FOR CONVERSION OF DECISION TABLES TO COMPUTER PROGRAMS. 

THE TECHNIQUE, AS PRESENTED, MAY GIVE UNDESIRABLY LONG RUN 
TIMES. A MODIFICATION IS PROPOSED TO HFLP ALLEVIATE THIS 
PROBLEM. 


661201 SHERMAN, PHILIP M. 

FLOWTRACE. a PROGRAM FOR FLOWCHARTING PROGRAMS. 

COMM. ACM 9, 1 2 1 DEC. l°66l, 8A5-854. 

FLOWTPACE PRODUCES FLOWCHARTS OF PROGRAMS WRITTEN IN ALMOST 
ANY PROGRAMMING LANGUAGE. META LANGUAGE AVAILABLE FOR 

o f scr i pt i on of syntax of control statements. 

670001 CALLAHAM, M.O. GRACE, G.L. 

AUTODOC: COMPUTER-BASED ASSISTANCE FOR DOCUMENT PRODUCTION 
PRQC. ACM CONE 22 1 19671 , 177-185 

A'JKIUUC IS A MAN-MACHINE DESIGNED TO PROVIDE AUTOMATED 

DOCUMENTATION plus this system permits thf added features 

OF DOCUMENT PRODUCTION, MAINTENANCE, AND 800KEEPING. 


670101 SPERRY RAND CORPORATION 

UN 1 VAC 1108 COBOL UP-4048 
UNI VAC CORPORATION 

THIS MANUAL EXPLAINS THE COBOL-L ANGUAGE AS IT APPLIES TO THE 
UNIVAC 1108 COMPUTER. 


6 7C40 1 TUPAC, J.t). 

AN APPROACH TO SOFTWARE EVALUATION 
NT I S-AD&51 812 

A PROCEDURE FOR SOFTWARE EVALUATION IS INTRODUCED. MAJOR 
ICE AS ARE WHEN ANO HOW A MANAGER SHOULO EVALUATE. TWO 
MAJOR AREAS CF SOFTWARE EVALUATION ARE FUNCTIONAL 
CAPABILITIES ANO PERFORMANCE. 


67 '' 4^2 


SAl I SOUPY , A.B . ENSLCW,JR. P.H. 

diagnostic programming fcr digital computers a bibliography 


NT I 5-AD8 1 3 8 31 

THIS BIBLIOGRAPHY CONSISTS OF 88 REFERENCES ON DIAGNOSTIC 
PROGRAMMING FOR OIGITAL COMPUTERS. EACH ENTRY INCLUDES 
AUTUJR(S) , TITLE, SOURCE, AN ABSTRACT (NORMALLY THF AUTHOR'S! 
AND USUALLY SOME COMMENTS PERTAINING TO ITEMS OF SPECIAL 


INTEREST OR ADDITIONAL INFORMATION TO HELP THE RFAOEP 
DECIDE IF the DOCUMFNT WOULD BE OF INTEREST TO HIM. 


6 7 CH 0 1 COMPRESS, INC. 

DOCUMENTATION SOFTWARE 

CAT AMAT I ON 13, 81 AUGUST 1967), 113-125 

U)“!C (DOCUMENTATION OF PROGRAMS IN CORE) GENERATES MACHINE 
PRODUCED FLOWCHARTS, CROSS-REFERENCE LIST AND CHART INDEX 
FOR OBJECT PROGRAMS. 


5 7CH02 KING, P.J.H. 

OEC I SI ON TABLES 

COMPUTER J. 10.8IAUG 196T) , 135-162. 

THE ARTICLE DESCRIHES THE BASIC FEATURES OF DECISION TABLE 
DEVELOPMENT, AND IT ILLUSTRATFS APPLICATIONS IN VARIOUS 
FIELDS. SOME PROGRAMMING TECHNIQUES ARF PRESENTED. AN 
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EXTENSIVE DECISION TABLE BIBLIOGRAPHY IS ALSO PRESENTED 
WITH EXPLANATION OF THE RELATIVE MERITS OF EACH. J® 

DO 

CHAPIN, N. 00 

PARSING OF DECISION TABLES 
COMM. ACM l C , 8 ( AUG l 967 ) ,507-510. 

DEALS WITH REDUCTION OF DECISION TABLES BY SEVERAL 

TECHNIQUES. TECHNIQUES CONSIDERED ARE BY PARSING WITH 
REGARD TO VERTICAL AND HORIZONTAL DATE STRUCTURES, JOB 
IDFNTITY, HARDWARE AND JOB PRIORITY, AND CONTF«T 
RELATIONSHIPS. THE PARSING RELIES ON CONVENTIONS FOR 
DECISION TABLE LINKAGE. 

670806 MARKS. S.L. ARMERDING, G.W. 

THF JOSS PRIMER 
NT I S-AD65 57 36 

AN INTRODUCTION TO THE JOSS TIMESHARING SYSTFM. IT IS AN 
ON-LINE, TIME-SHARED COMPUTING SERVICE DEVELOPED AT THF 
RAND CORPORATION TO PROVIDE THE SOLUTION OF NUMERICAL 
PROBLEMS. 

6 T090 1 ((ANNUM, T.J. A2 ZAP l, A. I. BROOKS, A. I. 

HUNTFR, J.R. STRINBFRG, L. CHUBB, G.R. 

DEVELOPMENT OE A COMPUTER PROGRAM FOR GFNER AT I NG 
T POUR LE- SHOUT I NG DECISION TREES 
NT I S-AD664603 

ESTABLISHES ALGORITHM FOP CENFRATING A DECISION 

LOGIC-STRUCTURE UR TREE DIAGRAM FORM WHICH PSOCEOURAL 
T ROUBLE SHOOTING INSTRUCTIONS COULD BE PREPARFD. 

671101 HOWDEN, W. E. 

A PROGRAM FOR THE CONSTRUCTION OF PFRT FLOWCMAPTS 
COMPUTFR JOURNAL 1C, 11 (NOV. 1967 ), 2T8-281 
APPLICATIONS OF CPM ANO PFRT OF T fc N INVOLVE FLOWCHARTS AND 
NFTvJRKS. PFRT DIAGRAMS MUST BE TASY TO READ TO ?E USTFUL. 
IN THIS ARTICLE, EVENTS AND ACTIVITIES THAT FORM A 
SUBNETWORK ARE GROUPED TOGETHER AND PROXIMITY OF ANY TWO 

NETWORKS REFLFCTS their interdependence. 

6T1102 REINWALD. L.T. 

CONVERSION OF LIMITED-ENTRY DFCISION TABIFS Tl OPTIMAL 
CUMPUTER PROGRAMS IIS MINIMUM STORAGE REQUIREMENT 
J. ACM 14 , 1 U(UCT 19671 , 742-756. 

AN ALGORITHM IS DEVELOPED WHICH WILL CONVERT ANY LI^ITCD 
ENTRY DECISIUN TABLE TO A COMPUTER PROGRAM WITH MINIMAL 
STORAGE REQUIREMENT. IT IS INITIALLY PE VE L n PEO F n R 
PROGRAMS WITH A TREE-LIKE FORM AND THEN EXTENDED. THIS 
ALGORITHM CAN BF COMBINED WITH ONE FOR MINIMUM AVERAGE 
PROCESSING TIME, RESULTING IN A MINIMUM AVERAGE COST 
PROGRAM. 

6 7 1 20 1 COMP. SCI. DEPT • UNIVERSITY OF ILLINOIS 

ILL I AC IV QUARTERLY PROGRESS REPORT 

NT I S- ADf>6 72 80 

A REPORT ON THE PROGRESS nF THE I LL I AC IV SYSTEM IS LISTEO. 
THIS INCLUDES THE GP APHI CAL DISPLAY SYSTEM. 


6708C2 

670803 


671202 


JONES, M.V 
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bTlZ n 2 COMPUTERIZING A GOVERNMENT DATA SYSTEM: A MANAGEMENT 

OVERVIEW OF THE STEPS REQUIRED AND THE TIME NEEDED. 
NTIS-AD6927B4 

THIS PAPER DISCUSSES WHAT MUST BE DONE AND HOW LONG IT WILL 
TAKE TO CONVERT A MANUAL UATA SYSTEM IN A GOVERNMENT 
AGENCY TO A COMPUTERIZED SYSTEM. 

680101 LUDwIG, H.R. 

SIMULATION WITH DECISION TABLES 
J. DATA MGMT. 6.11 JAN 196R), 20-27. 

THE ARTICLE DEALS PRIMARIIY WITH A SIMULATION PROCEDURE, 
USING THE DECISION TABLE STRUCTURE TO GOVERN THE BEHAVIOR 
OF THE QUEUING ACTION. A SIMPLIFIED ALGORITHM IS PPESFNTED 
IC SHOW SOMEWHAT HCW THE OECISION TA8LE STRUCTURE WAS 
USED. 

6 80152 NATIONAL MILITARY COMMAND SYSTEM SUPPORT CENTER COMPUTER 

IBM CORPORATION 

USER'S MANUAL NMCS INFCRMATICN PROCESSING SYSTEM <NI»S! (IBM 
1410/70101 
Nil S-ADR 50717 

NMCS INFORMATION PROCESSING SYSTEM (IBM 1410/70101 IS 
DESCRIBED IN SIK DOCUMENTS (l)SYSTEM DESCRIPTION, 

I 21 OPERATOR* S MANUAL ,< 3 I USER ' S MANUAL , < 4 I ANAL YT IC AL MANUAL 
(51PR0GRAM DESCRIPTION, AND I 6 1 DAT A BASE DOCUMENTATION 

680103 MEL'CHUK, I. A. 

AUTOMATION IN LINGUISTICS 
NT I S-A07 342 1 5 

THIS ARTICLE RELATES THE PROBLEMS OF AUTOMATION IN LINGUIS- 
TICS. RFV1EWS AND EXERTS OF TRANSLATIONS BY EXPERTS ARE 
DISCUSSED. 

66020 1 CEFENSE DOCUMENTATION CENTER 

BIBLIOGRAPHY ON INFORMATION SCIENCES. VOLUME I 
O0C-AD829501 

THIS BIBLIOGRAPHY IS A COMPILATION OF RCECRENCES IN THE AREA 
OT INFORMATION SCIENCE AND TECHNOLOGY. THC REFERENCES 
REPRESENT RESEARCH UN THE BASIC ACTIVITIES COMMON TO MOST 
I NE UR MAT ION-ORIENTED MISSIONS. 

680202 DEMUTH, N. CONTI, E. 

STUDY UF MACHINE-AIUEO POST EDITING 
DOC -A0B28584 

THE PRIMARY OBJECTIVE OF THIS REPORT WAS TO DETERMINE THE 
FEASIBILITY OF MACHINE-AIDED POST EDITING AT ETD. ERROR 
OETECTIUN ANALYSIS WAS USED TO OFVELOPF AN EXPERIMENTAL 
POST-EDITING SYSTEM (XPFI. 

680351 NATIONAL COMPUTER ANALYSIS, ISC. 

COBOL FLOWCHARTING 

DATAMATION 14, 3 ( MARCH 1968), 135. 

NATIONAL COMPUTER ANALYSIS, INC. PRINTS AND MAILS BACK 
FLOWCHARTS ARE PRODUCE!) FOR AND COBOL PROGRAM DFCKS. 

680352 IBM CORPORATION 

NIC S INFORMATION PROCESSING SYSTEM IBM 1410/7010 GENERAL 
PURPOSE COMPONENTS MULTIFILE OUTPUT AND FILE GENERATION 


PAGE R 

6 80 302 NT I S-AD-834970 

NMCS INFORMATION PROCESSING SYSTEM (IBM 141D/7riw| IS 
DESCRIBED IN SIX DOCUMENTS 1 1 I SYSTEM DESCRIPTION, 

I 2 IUPE RAT OR* S MANUAL , I 3 I USER* S MANUAL ,( 4 ) ANAL TT ICAL MANUAL 
( A) PROGRAM DESCRIPTION, AND ( 6) DATA BASE DOCUMENTATION 

680303 IBM CORPORATION 

SYSTfc, M/360 ADMINISTRATIVE TERMINAL SYSTEM— OS 
IBM CORPORATION 

THIS SYSTEM CONSISTS OF CONTROL AND FUNCTIONAL PROGRAMS THAT 
PFRMIT MANY 01FFFPENT TEXT-PROCESSING AND OAT A-HANOL ING 
ACTIVITIES TO BE CARRIED ON SIMULTANEOUSLY THROUGH DIFFER- 
ENT TFRMINALS ATTACHED TO AN IBM SYSTEM/360. 

680501 CHAPIN, N. 

PROGRAM DOCUMENTATION: THE VALUABLE BURDEN 
SOFTWARE AGE, 2IMAY 19681,24-26 

ADVANTAGES AND OBJECTIVES OF DOCUMENTATION ARE DISCUSSED. 
TWFLVE MAJOR DOCUMENTATION ELEMENTS ARE LISTED. 

680601 NINKE, W. H. 

THE GROWTH GF CO“PUTFR GRAPHICS AT BELL L A30RATOP I FS. 

BELL LABORATORY RFCORO 46, 61 JUNE , 1 968 1 , 13C 
COMPUTER GRAPHICS IS A USEFUL TECHNIQUE EUR COMMUNICATING 
WITH COMPUTERS. THIS TECHNIQUE IS HELPING MAN MAKE MrfiF 
EFFECTIVE USE OF THE MACHINE Tp SOLVE A WIDE VARIETY n F 
PROBLEMS WHILE PROVIDING A RECORD CF PROBLEM SOLUTION. 

680701 FERGUS, R.M. 

AN INTRODUCTION TO DECISION TABLES 

SYSTEMS AND PROCEDURES J. 1 q .4( JULV-AUG 19681, 24-2 7 • 

THIS ARTICLE DESCRIBES THE CHARACTERISTICS OF DECISION 
TABLES, ALSO GIVING GUIDFLINFS AND EXAMPLES OF TABLE 
CONSTRUCTION AS INITIAL STEPS TOWARD THE USE OF TABLFS TO 
PERFURM, COMMUNICATE AND LOCUMENT DECISION MAKING. 

680801 O'BRIEN, F. BECKWITH, o.C. 

A TECHNIQUE F0» COMPUTER FLOWCHART GENERATION. 

COMPUTER JOURNAL 11, SIAUG. 1969), 1 39-140. 

AN APPROACH TO COMPUTER FLOWCHART GENERATION CALLFO ICFLOW. 
PROGRAM IS SIMPLE A.\0 FAST All) WHICH PRODUCE AN 
UNAMNOTATEO LINEAR FLOWCHART. THE FLOWCHARTS ANNOTATION 
HAS BEEN LEFT TO THE PROGRAMMER CONCERNED. 

680802 GRINDLEY, C.B. 

THE USE OF DECISION TABLFS WITHIN SYSTEMATICS 
COMPUTER J. 11, SIAUG 19681,129-133. 

SYSTEMATICS IS A SET of TECHNIQUES FOR DESIGNING AND 

DEVELOPING INFORMATION SYSTEMS. A GENERALIZED OFSC.RIPTION 
OF OECISION TABLES IS PRFSFNTEJ. THE FORM OF DECISION 
TABLE USED IN A SYSTEMATICS TECHNIQUE IS DESCRIBED ALONG 
WITH ADVANTAGES GAINED FRO" IT. 

680901 FERGUS, P.M. 

G 10 D OECISION TABLES AND THE 1 0 USES 

SYSTCMS AND PROCEDURES J. 1 9 , 5( SE PT-OCT 19681,18-21. 

SEVEN STEPS ARE GIVEN FOR IMPLEMENTATION OF DFCISI5N TABLE 
USE WITHIN AN ORGANIZATION. TABLFS CAN BE USED AT MAtJY 

ro 

so 
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6 8f9n LEVELS OF AN ORGANIZATION. TABLES CAN BE ANALYZED TO 

PROMOTE COMPLETENESS AND ACCURACY ANO TO DETECT EXCESSIVE 
RliLCS. CONTRADICTIONS. 

68C902 IBM CORPORATION 

INDEX PREPARATION fOR PUBLICATIONS INDUSTRY 
IBM CORPORATION « 36CO-2 9.4 . 004 

THIS PROGRAM PRODUCES AN INDEX IN DOUBLE-COLUMN FORMAT WHICH 
IS SUITABLE FOR REPRODUCTION BY PHOTO OFFSET PRINTING. THE 
PROGRAM WOULD BE OF VALUE TO ANY PUBLICATION DEPARTMENT 
THAT HAS TO PREPARE INOEXFS AS A PART OF ITS PUBLICATIONS. 

681001 KING, P.J.H. 

AMBIGUITY IN LIMITED FNTRY DECISION TABLES 
COMM. ACM 11.10I0CT 1968) .680-684. 

AUTHOR CLAIMS RULES CONCERNING REDUNDANCY , CONTRADICTION AND 
COMPLETENESS AS ESTABLISHED IN 1963 ARE UNSATISFACTORY. 
AMBIGUITY IS CLAIMED TO BE AN IMPORTANT ASPECT IN CHECKING 
TABLES. PROCEDURE FOR PRODUCING CHECKED OUT TABLES IS 
PROPOSED. IMPORTANCE OF WELL-OESICNEO DIAGNOSTIC 
FACILITIES IS EMPHAS I ZEO. 

6 81002 DEFENSE DOCUMENTATION CENTER 

COMPUTER IN INFORMATION SCIENCES; VOLUME III 
DDC-AD846300 

THIS BIBLIOGRAPHY COMPILES REFEPENCFS OEALING SPECIFICALLY 
WITH THE ROLE OF COMPUTERS IN INFORMATION SCIENCES. 

6B1DD3 KALTBV, O.J. 

CONTROL SECTION CROS S-R E F FRENCE ANO LINK EOIT EDITOR 
IBM CONTRIBUTED PROGRAM U3RARY 

THESE TWO ASSEMBLER PROGRAMS MAY PROVE USEFUL IN ANALYSIS 
' ANU DEBUGGING WORK WITH RESPECT TO LARGE AND COMPLEX 
PLANNED OVERLAY MODULES. 

bBllOl R3SFN, M.H. LOBACK, L.R. 

S/36* ASSEMBLER/COMPILER LISTINGS LIBRARY MAINTENANCE, 

NO. 3600-00. P.015 

IBM CORPORATION, HAWTHORNE, NY, 1968 

THIS PROGRAM CREATES AND MAINTAINS A LIBRARY OF CURRFNT DOS 
ASSl^HLER AND/CR COMPILER (FORTRAN, PPG, COBOL, PL/II 
OUTPUT LISTINGS ON IBM 2311 CR 2316 CASO, USING A SPACE 
COMPRESSION TECHNIOUE. IT RUNS ON ANY S/360 UNDER OOS, 
SUPPORTING DAM (DIRECT ACCESS METHOD), REQUIRING AT LEAST 
16K OF STORAGE. 

69C101 IBM CORPORATION 

PROBLEM LANGUAGE ANALYZER (PLAN) USERS’ INTRODUCTION 
IBM CORPORATION, WHITE PL A I NS ,N. Y. , 19 69 

THE IBM PROBLEM LANGUAGE ANAL YZER I PL AN ) WAS DESIGNED TO LOW- 
ER THE CUST OF DEFINING, IMPLEMENTING, ANO USING PROBLEM-OR- 
IENTED LANGUAGES. PLAN IS A SET OF PROGRAMS THAT OPFPATES 
ON THREE LEVELS A SUPPORT LEVEL TO HELP THE PLAN PROGRAMM- 
ER PRODUCE NEW MODULES TO GIVE APPLICATION DESIGNERS STAN- 
DARD COMMANDS FOR CATALOGING THE SEMANTICS OF A NFW POL TO 
ACCEPT INPUT STATEMENTS, EXFCUTE ANO PROOUCE RESULTS 

690102 IBM CORPORATION 
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690102 SYS TE M/ 360 FLOWCHART USER’S MANUAL ■*, 

OPERATOR’S MANUAL I 

IBM CORPORATION, WHITE PL A I NS ,N. Y . , 19 69 CO 

THE IBM SYSTEM/360 FLOWCHART PRODUCES PROGRAM FLOWCHARTS^ 
UNDER THE IBM OOS. THIS DOCUMENTATION AID IS I NT t NOE 0 TO 
TU MINIMI ZE THE PLANNING AND EFFORT RFO'JIPFD TO PRODUCT 
AND MAINTAIN PROGRAM DOCUMENTATION. 

690103 GRAY, M. LONDON, K.P. 

DOCUMENTATION STANDARDS 

BRANDON/SYSTEMS PRFSS, PRINCETON, 1969 

THIS DUOK GIVES AN OPINIONATED OVERVIEW OF WHAT 

DOCUMENTATION STANDARDS SHOULD BF. INCLUDED ARE S Y5TFMS 
DEVELOPMENT DOCUMENTATION AND PROGRAM DOCUMENT AT I ON FRO* A 
DATA PROCESSING VIEW-POINT. NUMEROS FORMS AND EXAMPLES ARE 
SHOWN. FLOWCHARTS, DECISION TABLF AND SYMBOL STANDARDS 
(NATIONAL) APE INCLUDED IN THE APPENDICES. 

690301 IBM CORPORATION 

A CONVERSATIONAL CONTFXT-DIRFCTED EDITOR 

IBM CAMBRIDGE SCIENTIFIC CENTER , CAMBRIDGE, M4 11960) 

THIS ON-LINF EDITOR OPERATES UNDER THE CP-6T/CYS AND 

ON-LINE/OS SYSTEMS. IT ALLOWS EDITING OF F1LFS LARGER THAN 
AVAILABEL CORE SIZE ONLY BY BRINGING IN A BLOCK AT A TIME 
FOR FDITING, WITH NO BACKWARD BLOCK ACCESSION ALLOWED. 

690601 REAM, N.J. 

ON-LINF manAGFMCNT SYSTEMS INFORMATION 
DATAMATION 1 C , 6( APR I L 1 R 6° 1,39 

D1CUSSES THE NEED FuR PROGRAMMING STANDARDS AND A F nD v AT 

SYSTFM OF DOCUMENTATION WHICH HELPS DETERMINE ThF RELATIVE 
SUCCESS DF THE EFFORT IN COMPLETING THFSE STANDARDS. 

6 9090 1 CONTROL DATA CORPORATION 

CONTROL data 64D0/65CL /66 r 0 COMPUTFR SYSTEMS COB n L REFERENCE 
MANUAL PUBLICATION NUMBER 6G1912CP 
CONTROL DATA CORPORATION 

THIS MANUAL EXPLAINS IIOW TC USE VERSION 3.1.6 OF THE SRDPR . 
OPERATING SYSTEM TO EXECUTE PROGRAMS WRITTEN IN VERSION 
2.1 OF CDC 660Q/65CC /66C0 COBOL. 

691001 CONTROL DATA CORPORATION 

CONTROL DATA 6600/6500/6 COMPUTER SYSTEMS CO“PASS 
REFERENCE manual PUBLICATION NUMBER 6019590'' 

CONTROL DATA CORPORATION 

THIS MANUAL DISCUSSES PROGRAM STRUCTURE AND ORGANIZATION, 
COMPASS LANGUAGE CODING, OPERATION CODES, PSEUDO 
INSTRUCTIONS, MACROS, MICROS, AND ASSEMBLER INPUT/OUTPUT 
UNDFR THE COMPASS SYSTEM. 

691101 KIND., P.J.H. 

THE INTCRPRFTAT1 ON OF LIMITFO FNTRY DECISION TABLE FORMAT 
ANO K FL AT I ON SH I PS AMONG CONDITIONS 
COMPUTER J. 12,111 NOV 1 96° 1,320-326. 

THIS ARTICLE EMPHASIZES THE INTERPRETATION OF BASIC F 0R M AT . 
RELATIONSHIPS AMONG CONDITIONS ARE SHOWN, A SEPARATE 
MATTER FROM BASIC FORMAT. FORMAL DEFINITIONS ARE PROPOSED. 
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641102 IBM CORPORATION 

IBM SYSTr.M/360 OPERATING SYSTEM LINKAGE EDITOR AND 10A0ER 
PROGRAM NUMBERS 360S-ED-510 360S-ED-521 360S-L0-S47 
IBM CORPORATION 

THE MANUAL DESCRIBES THE LINKAGE EDITOR AND LOADER WHICH ARE 
TWO PROGRAMS THAT PREPARE THE OUTPUT OF THE LANGUAGE 
TRANSLATORS FOR EXECUTION. 

691103 CONTROL OATA CORPORATION 

CONTROL OATA 64C0/65C0/66O0 COMPUTER SYSTEMS fORTRAN 
REFERENCE MANUAL PUBLICATION NUMBER- 60174900 
CONTRtK OATA CORPORATION 

THIS MANUAL EXPLAINS HOW TO USE FORTRAN VERSION 2.3 UNOER 
VERSION 3 OF THE SCOPE OPERATING SYSTEM. 

7CC301 WALSH, 0. 

A GUIDE FOR SOFTWARF DOCUMENTATION 
MCGRAW-HILL ,NY ,NY,19TC 

CONTAINS 14 CAREFULLY PREPARED KOCELS CF DOCUMENTATION WHICH 
MUST BE PREPARED FOR COMPUTER SOFTWARE AND APPLICATIONS 
PPODUCTS. 

7CGV32 GRAY, M. 

DOCUMENTATION STANDARDS 

ORANOUN/SYSTEMS PRESS, INC. .NEW YORK, NEW YORK, 1969. 

BOOK WAS WRITTEN TO PROVIDE OP MANAGERS, SUPERVISORS AND 
ANALYSIS A PRACTICAL GUIDE FOR DESIGN ANO IMPLEMENTATION 
OF STANDARD COCUMFNTATION SYSTEM. AUTHOR SURVEYS THF TYPES 
OF DOCUMENTATION. THE CONTROL ANO MAINTENANCE OF SAID 
DOCUMENTATION, ANO, IN APPENDIX FORM. HAS AN INOEXFO 
GLOSSARY CF FORMS USED, FLOWCHARTING STANDARDS, ANO 

0 EC I S I ON table standards 

7C03D3 USA F 

MILITARY standards 

USAF,MIL-ST0,19T0 

THESE DOCUMENTS GIVE OETAILEn DESCRIPTIONS OF WHAT THE 

MILITARY EXPECTS TU FIND WITH RESPECT TO ITS PPUGRAMS ANO 
COMPUTER SYSTEMS. SPECIAL EMPHASIS IS ON VARIOUS FORMS AT 
ALL LfV c LS, AUTHORISATION ANO INTER-RELATION BETWEEN 
PROJECTS. SOME OF THE 'WHY' OF DOCUMENTATION IS ALSO 
I NCLUDEO. 

7 CO 101 COMAS, K.A. 

nVERLAM TREE PROCESSOR 

IBM CONTRIBUTED PROGRAM LIBRARY 

THIS PROGRAM WILL CREATE A GRAPHIC REPRESENTATION OF THE 
STRUCTURE OF AN OVERLAY PROGRAM ANO OPTIONALLY RECREATE- A 
OFCK OF SEQUENTIALLY NUMBERED CARDS, WHICH, THE LINKAGE 
EDITOR WILL RECREATE THE SAME PRECISE STRUCTURE. 

700301 BARNES, L. 

RUNCFF: A PROGRAM FOR THE PREPARATION OF DOCUMENTS 
NT I S-A07PTAC2 

THIS ! S A USERS MANUAL FOR THE LANGUAGE RUNOFF. IT IS A 
TIME-SHARING TEXT-EDITING DOCUMENT PREPARATION PROGRAM. 


TC0401 


MILLS, H.D 
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700401 SYNTAX-DIRECTED DOCUME NT AT 1 ON FOR PL360 

COMM. ACM 1 3( APR I L 197-01,216-222 

PL36C IS USFO AS BASIS FOR ILLUSTRATING IDEA CALLED 

•SYNTAX-DIRECTED' DOCUMENTATION. IT USFS SYNTACTIC TYPES 
ANO IDENTIFIERS TO TRIGGER AUTOMATIC FORMATION OF 
QUESTIONS TO PROGKAMMEP, WHOSE ANSWERS WILL BECOME PART 
OF THE DOCUMENTATION. IT ALSO PROVIDES AUTOMATIC STORAGE 
AND RETRIEVAL FACILITIFS SO OTHFR PROGRAMMERS CAN ACCESS 
THE RESULTING DOCUMENTATION. 

70P601 MUTHUKR ISHNAN, C.R. 

ON THE CONVERSION OF DECISION TABLES TO COMPUTFR PROGRAMS 
COMM. ACM 13,61 JUNE 1970,347-351. 

AUTHORS DISCUSS EXECUTION TI“E DIAGNOSTICS AS A MFANS OF 
POINTING OUT AMHIGUITIFS IN DECISION TABLES. TwO 
ALGORITHMS ARF PRESENTED FDR PROGRAMMING DECISION TABLES. 
THF ALGOR ITHMS HAVE THE MERITS CF SIMPLICITY (IF 
IMPLEMENTATION AND DE TFC T I CN OF AMfllCUITIFS AT EXECUTION 
TIME. FEATURES OF A TRANSLATOR PREPARED BY THF AUTHORS ARE 
ALSO DISCUSSED. 

700602 IBM CORPORA! I UN 

IBM SYS Tf M/ 360 OPERATING SYSTE“ FULL AMERICAN NATIONAL 
STANDARD COBOL PROGRAMMERS GUIDE NUMBERS 36 , 'S-CB-S45 
IBM CORPORATION 

THIS MANUAL EXPLAINS HOW TO USE 3S/36C TO COMPILE LINK-EDIT 
AND EXECUTE PROGRAMS WRITTEN IN VERSION 2 OF IBM'S FULL 
COBOL COMPILER. 

700603 IBM CORPORATION 

IBM SYS TC M/ 360 OPERATING SYSTEM. FORTRAN IV IG AND HI 

PROGRAMMERS GUIDE PROGRAM NUMBERS 36'~ S-F0-5BC 36CS-FD-5?'' 
IBM CUR POP A T ION 

THIS MANUAL EXPLAINS HOW TO USE US/360 TO COMPILE LINK-EDIT 
ANO CXFCUTE PHUGRAMS WR I T TF N IN IBM FORTRAN IV. 

700604 FOGG, L.W. 

CLOT - CARD LIBRARY ON TAPE 

INTERNATIONAL TELECONTROL CORPORATION, W II M INGTPN, OE (1970! 
THIS BROCHURE DESCRIBES THE INPUT TO, CAPABILITIES OF, AND 
OUTPUTS F RUM THE T APE-C C I ENTE n OFF-LINE PROGRAM EDITOR 
•CLOT'. OEVICE AND STGPAGE R F QUI R EVENTS , CIST, ANl) SAMPLE 
OUTPUT ARE ALSO GIVEN. 

700701 BLUMRFKG, S.E. 

AN INTERIM PROGRESS REPORT OF COMPUTER OUTPUT MICROFILM 
ACTIVITIES ANO EXPERIENCES 
NT I S-AD7C8600 

THE PROCESS, CO MPUTER-OUTPUT-MI CROF I LM I COM) , IS DISCUSSED 
WITH RESPECT TO ITS APPLICATION AT THE DEFENSE 
DOCUMENTATION CENTER. ADVANTAGES AND COST-ANALYS 1 5 ARE 
EMPH4SISE0. 

700801 WICKER, R. NFPERLO, R. T EPLIT2. A, 

MICROFICHE STORAGE AND RETRIEVAL SVSTFMS STUDY: 

NT I S-AD71 3100 

THE OBJECTIVE OF THE STUDY WAS TO DFTERMI NE USER REQUIREMENT 

ANO DrVELOP DESIGN OBJECTIVES AND SPECIFICATIONS FOR A 

J* 

I 

CO 
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700801 
7 CC9C 1 

7C0902 

700903 

7CD904 

7CC9D5 

701101 

701102 


LCW-COST MICROFICHE STORAGE AND RETRIEVAL SVSTEM. DESIGN 701102 

OBJECTIVES AND SPECIFICATIONS FOR TWO OPTIMUM STORAGE ANO 
RETRIEVAL OE V ICES ARE PRESENTED. 

VAR TARE 0 I AN , A.G. 

THE OESIGN OF VISUAL DISPLAYS 

p^LL LABORATORIES REPORT 40, 8ISEPT 19701. 226. 

VISUAL DISPLAYS APPEAL TO THE ECONOMY OF CRT DISPLAYS FOR 701103 

man-machine interplay, communication can be increased 

THROUGH CAREFULLY CHOOSING THE CARACT £R I ST ICS OF THE 

display symbols. 


01 AL , R .6. 

DECISION TABLE TRANSLATION 

COM**. ACM 13.9ISEPT 19 701,571-873. 

THE AUTHOR PRE Sf NTS AN ALGORITHM FOR CONVERSION OF A LIMITED 
ENTRY DECISION TAOLf INTO A MACHINE PROCESSARLE 
•jEST-AND-BRANCH MATRIX. HE POINTS OUT THE RELATION OF THIS 
ALGORITHM TO UTHERS IN THE LITERATURE OF SIMILAR DESIGN 

701104 

STANFORD UNIVERSITY COMPUTATION CENTER 

WY L OUR 

STANFORD UNIVERSITY COMPUTATION CENTER# STANFORD, CA C19T0I 

THIS PACKAGE CONSISTS OF AN MVT M ILT EN/VYLHUR OPERATOR’S 
GUIDE (MISNOMER — REALLY A USER REFERENCE MANUAL). WYLBUR 
IS AN ON-LINE EDITOR ANO REMOTE JOB ENTRY AND RETRIFVAI. 

SYSTEM USING SELECTRIC TYPEWRITER TCPMlNALS IN EITHER AN 
MET OR MVT ENVIRONMENT. WYLBUR’S PROGRAM EDITING CAPABIL- 
ITIES ARE TREATED AS A SUBSET OF ITS FREE-FORM TFXT EDIT- 701105 

ING CAPABILITIES. THE COVER LETTER WAS PRODUCED BY WYIRUP 

feldmann, c.g. 

maintenance and enhancement of the aed system 

ODC- A 9378211 

(SEE AOB75395 FOR DESCRIPTION! 

AMERICAN NATIONAL STANDARDS INSTITUTE, INC. 

AMERICAN NATIONAL STANDARD FLOWCHART SYMBOLS AND THEIR USAGE 

IN INFORMATION PROCESSING TC1106 

AMERICAN NATIONAL STANDARDS INSTITUTE INC, X395-1970, NY, NY, 
l 979 

THIS DOCUMENT GIVES A OETAILED DESCRIPTION OF FLOWCHART, 

SYMBOL ANO DECISICN TABLE STANDARDS ACCEPTED BY ANSI. 


GTETZ, M.A. 

A‘JT OF LOW ENHANCEMENTS (IF DOCUMENTATION ANO MAINTENANCE OE 
SCIENTIFIC APPLICATIONS 

AUTOMATED METHCOS OF COMPUTER PROGRAM DOCUMENTATION, 701107 

(NOV 19701 

THE AUTHOR PROPOSES AND DISCUSSES THE FOLLOWING THREE 
ELEMENTS WHICH HE FtELS APE ESSENTIAL TO PPOVIDING A 
INTFGRATEO DOCUMENTATION SYSTFM: IIICGICAL ANALYSIS OR 
GRAPHIC DISSFCTION OF A PROGR AM< AUTUFLOW ! , 2 1 H ISTOP Y ANO 
CONTROL OF PROGR AM (L l OR AR I AN! , 3 IUNOERST ANDING THE PROGRAM 
I Tf«T EDIT PROGRAM). 


MOUTON, H.t, 

DOCUMENTATION! MOTIVATION ANO TRAINING OR AUTOMATION 
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AUTOMATED METHODS OF COMPUTER PROGRAM DOCUMENTATION, 

I NOV 1970! DO 

THE AUTHOR DESCRIBES WHAT MANUALS NEFD TO BE OEVELOPEO WHILE 
DESIGNING A SYSTEM, BY WHOM AND FOR WHOM THEY APE DESIGNED 
, AND EMPHASIZES THE NEED FOR DEVELOPING SYSTEM DOCUMENTS 
BEFORE SYSTEM IS FINISHED. 

WOLF, A . W. 

MAKING AUTOMATED COMPUTER PROGRAM DOCUMENTATION A FEATURE OF 
TOTAL SYSTEM DESIGN 

AUTOMATED METHODS OF COMPUTER PROGRAM DOCUMENTATION, 

(NOV 1 9 ZC I 

THE AUTHOR NOTES THAT OOCUMFNTS ARE OFTEN THE AFTFRMATF OF 
SYSTEMS DESIGNS. HE DISCUSSES THE DESIGN OF A NEW SOFTWARE 
SYSTEM BY AFSCF FOR THF AIR FORCE, AND THE PROBLEMS OF 
DOCUMENTATION. OF SPECIAL INTEREST IS THE DISCUSSION OF. 
THF DATA BASE DESCRIPTION CALLED • COMPOOL • FOP COMMON POOL 
OF INFORMATION. 

NEELY, M.D. TYSON, J.W. 

AUTOMATIC PROGRAM ANNOTATION (AUTCNOTE) 

AUTOMATED METHODS OF COMPUTER PROGRAM DOCUMENTATION, 

(NtlV 1979 1 

THIS PAPER DESCRIBES A HYPOTHETICAL AUTOMATIC DOCUMENTATION 
SYSTFM BASED CN SUPPLEMENTING RATHER THAN REPLACING T HC 
PROGRAMMER COMMENTS IN THE SOURCE DECK. IT IS VF R Y 
DETAILED. 

PARDEE, S. 

BFLIFLOW AUTOMATIC FLOWCHARTING SYSTEM 

AUTOMATED METHODS OF COMPUTFR PROGRAM CUCU M ENT ATI9N, 

(NOV 1979) 

THF BELLFLOw SYSTFM IS DISCUSSED WITH RESPECT TO Thf THREE 
HUDFS OF OPERATION. THEY ARE CALLED THF S°U->CF ''OOF • 
COMMENT MODE, AND MIXEC V^>DE. THF BELLFLOM SYRTr'# ALLOWS 
FOR USEFUL AND MEANINGFUL CC“MENTS Tn DF«IVF A AUTOMATIC 
FLOWCHART. BELLFLOW IS A tabLE-CRIVEN SYSTFM. 

HANNF V , R. 

AN AUTOMATED SYSTEM FOR GFNF R AT I NG PROGRAM DOCUMENTATION 

AUTOMATED METHODS CF COMPUTER PROGRAM DOCUMENT A T T ON , 

(NOV 1 970 ) 

THF AUTHOR DEVELOPED A OCCUMFNT AT ION PROGRAM WITH FMoHASIS 
PLACED ON TEXT CONTENT RATHER THAN FLOWCHARTING. THE 
PROGRAM GENERATES THE ENTIRE DOCUMENT ANO |T IS KCVWDPD 
ORIENTED. 

GROSCH, H.R . 

VIEWS ON COMPUTER PROGRAM DOCUMENTATION AND AUTOMATION 

AUTOMATFO METHODS OF COMPUTER PROGRAM DOCUMENTATION, 

(NOV 1970) 

DR. GROSCH EXPRESSES SO'*E BROAD OPINIONS AND PHILOSOPHY 
ABOUT THE PROBLEMS OF DOCUMENTATION AND DESCRIPTION, HE 
CAUTIONS ABOUT THF SFMANTICS ON THE SUBJECT OF 
DOCUMENTATION. SOME ESTIMATED COSTS CF COMPUTING AND DATA 
PROCESSING IN THE FEDERAL ESTABLISHMENT ARE ALSO GIVEN. 

MCCLURE, C.W. 
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701108 AUTOMAT ED ENGINEERING DESIGN AN APPROACH TO AUTOMATEn 

documentation 

AUTOMATED METHODS OF COMPUTER PROGRAM DOCUMENTATION. 

(NOV 197C) 

THE AUTOMATED ENGINEERING OESIGN SYSTEM IS A SYSTEM OF 
COMPUTER PROGRAMS DESIGNED FOR USE IN OUILDING SOFTWARE 
SYSTEMS. DOCUMENTATION (ANYTHING THAT HELPS A PERSON 
UNDERSTAND A PROGRAM) IS A NECESSARY PART OF SOFTWARE 
DEVELOPMENT BECAUSE THE SOFTWARE HILL INVARIABLY UNDERGO 
CHANGES OVER THE YEARS. 

701 1^9 LANZANU, B.C. 

PROGRAM AUTOMATED DOCUMENTATION METHODS 
. AUTOMATED METHCOS OF COMPUTER PROGRAM DOCUMENTATION. 

(NOV 19701 

THIS PAPER PRESENTS A DESCRIPTION OF A PROGRAM WHICH ASSISTS 
IN AUTOMATING THE DOCUMENTATION OF SUBROUT INESI AOS I , AN 
EXPOSE OF TWO FLOWCHARTING PR OGR AMS ( AUTOFLOW. FLOWGEN ) . 

SOME NOTES ON USEFUL PROGRAM INTERNAL CROSS-RFFEREMCF 
INFORMATION, A TEXT-EDITING PROGRAM FOR A TIMF-SHAPED 
ENVIRONMENT, A SYSTEM TO AID PROGRAM DOCUMENTATION 
UTILIZING A GRAPHICS OISPLAY CONSOLE. 

7 Cl 1 1 0 THOMAS, V.L. 

AUTOMATED DOCUMENTATION OF AN ASSEMBLY PROGRAM 

AUTOMATED METHODS OF COMPUTER PROGRAM DOCUMENT AT I UN , 

(NOV 1970) 

THIS PAP FR IS AN AUTUMATIC DOCUMENTATION PROPOSAL WHICH 
EXTRACTS COMMENTS FROM CODE AND OUTPUTS IT IN AN ORDERtY 
LIST SEPARATE FROM THE LISTING. 

701111 XU*', M.C. 

COSMIC: program DOCUMENTATION EXPERIENCE 

AJTCMAT ED METHCOS CF COMPUTER PROGRAM DOCUMENTATION, 

(NOV 1970) 

THE PAPER DESCRIBES THE MINIMUM DOCUMENTATION EFFORT 
REQUIRED IN ORDER TO 01 SFMENATE PROGRAMS TO USERS IN A 
USABLE FORM. 

701112 RICH, R .P. 

A'J TCM AT 1C EOITING OF MANUALS 

HUFFLY OISCUSSFS EDITING SYSTEM (INFO 360) ANO PROVIDES AN 
OVERVIEW OF IT. ALSO PROPOSES A METHOD OF DOCUMENTATION 
C ALL FD ' MONUnuCUMt NT AT I ON ' WHICH IS A • SUP FR -L I ST I NG' (IF 
A PROGRAM. THIS METHOD WOULD HAVE ALL RELEVANT DOCUMENTA- 
TION NEtOFO FOP DESCRIBING THE PROGRAM, MAINTAINED WITH IT. 
WHEN THE PROGRAM IS UPDATED OR CHANGED THE APPROPRIATE 
DOCUMENTATION IS UPOATEO OR CHANGED ALSO. 

7C H 1 3 FELSMAM, W. 0. 

C3$T ADVANTAGES OF AN INTEGRATED DOCUMFNTAT ION APPROACH 

AUTOMATED METHODS OF COMPUTER PROGRAM DOCUMENTATION 
(NOV 1970) 

THE US C OF METAPROC.RAMS IS ADVOCATED TO REDUCE PROGRAMMING 
TIME ANO ASSUCIATED DOCUMENTATION PREPARATION. GENERIC 
PROGRAMS SHOULD BE WRITTEN WHICH CAN BE TAILORED BY MEANS 
OF A METAPROGRAM WHICH PROCESSES THE PARAMFTFPS TO PERFORM 
A SPECIFIC FUNCTION. DOCUMENTATION COST CAN PE FURTHER RE- 
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701113 DUCED THROUGH THE USE OF SMALL PRF DOCUMENT TO SUBPROGRAMS. 

7011 1 A LUE8KF, W.R. 

THE INTEGRATION OF SYSTEM SPECIFICATIONS AND PR n GRAM COSING. 

A REPORT ON EXPERIENCE OF THE MEDLARS II PROJ c CT. 
AUTOMATED METHODS OF COMPUTER PROGRAM DOCUMENT A T I ON 
(NOV 19701 

DESCRIBES CSC EXPERIENCE IN MAINTAINING UP-TO-DATF DUCUMFNTA 
T ION FUR ONF. MOKULE UF A VERY LARGE SCALE PRO J r C T , “EDL AP S. 
SEVERAL INNOVATIVE TECHNIQUES HAVE BEEN EXPLORED IN THE 
CONTENT OF MEDLARS' DATA MANAGEMENT ENVIRONMENT USING PL / I 
AS AN AUTOMATIC DOCUMFNTE'R. "L/l'S DATA DESCRIPTION 
PROVIDES AUTOMATIC DOCUMENTATION USING 'MASTF“ DESCRIPTION 
• OF DATA ELEMENTS, WITH MEANINGFUL NAMTS. 

701201 MEN KUS > B. 

DEFINING ADEQUATE SYSTEMS DDE. UMF NT AT I ON 
J SYSTEMS MGMT 21.12IDEC 1 97 1 I .,16-21 . 

AUTHOR OEFINES SYSTEMS DOCUMENTATION AND ENUMERATES F I VF 
FUNCTIONS PERFORMED BY ADEQUATE SYSTEMS DOCUMENTATION. HE 
ALSU LISTS SEVERAL IMPORTANT GENERAL CONSIDERATIONS AP^UT 
DOCUMENTATION. CATEGORIZES TWO AREAS, SYS T p MS DEVELOPMENT 
DCC OME NT A T I ON, AND SYSTEMS OPERATION DOCUMENT AT I [ N UNDER 
THE GENERAL HEADING OF SYSTEMS COC UMFNT AT ION. ALSO 
CONSIDERS STANDARDS. 

701202 BERKELEY, E.C. 

RESEARCH IN COMPUT FR- ASS t ST ED DOCUMENTATION OF COMPUTER 
PROGRAMS 
NTI S-ADT1RR51 

DISCUSSES THE PRUPLEM OF DOCUMENTATION OF COMPUTER PROGRAMS. 
PRF SEN TS A FURTHER MODEL OF A 'SIMULATOR-ANALYZER' 

C OMPUTFR PRUGRAM. A COMPLETE COMPUTfcR PROGRAM F0° AN SA IS 
ALSO PRESENTED. HE DISCUSSFS COMMENTS AND MNF “ONI C SYMBOLS 
IN COMPUTER PROGRAMS. 

701203 IBM CORPORATION 

IBM SYS TE MZ 360 OPERATING SYSTEM ASSEMBLER F PROGRAMME'S 
GUIDE PROGRAM NUMBER 360L-AS-C3 7 
IBM CORPORATION 

THIS MANUAL DISCUSSFS PRCGR A M ASSEMBLING, LINKAGE E 0 I T TNG , 
EXECUTING, INTERPRETING LISTINGS, ASSEMBLER PROGRAMMING 
CONSIDERATIONS, DIAGNOSTIC “ESSAGES, AND OBJECT OUTPUT 
CA'DS. 

710101 IBM CORPORATION 

IBM SYSTFM/360 OPERATING SYSTEM PL/I (PI PROGRAMMERS OUIO c 
PROGRAM NUMBER 36CS-NL-S11 
IBM CORPORATION 

THIS MANUAL EXPLAINS HOW TO USE OS/360 TO COMPIL' L INK -EOI T 
AND EXECUTE PROGRAMS WRITTEN IN IBM'S VERSION OF PLII. 

71C102 SPERRY RAND CORPORATION 

UNIVAC 11CB SERIFS OPERATING SYSTEM 

UNIVAC 11CD SERIES UPt- RATI NG SYSTEM NUMHFP R 1 R R REV. 2 
THIS MANUAL DISCUSSES THE BASE PORTION OF THE OPEPAT)nG 
SYSTFM (EXEC 8) AND THE ASSOCIATED SOFTWARE NFFDFP TO 
CONSTRUCT, EXECUTE, AND MAINTAIN USER PROGRAMS. ^ 

I 

co 

co 
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710103 SPERRY P AND CORPORATION 

ED PROCESSOR - UNIVAC 11CO SERIES OPERATING SYSTFM 
PROGRAMMER REFERENCE 

SPERRY RANO CORPORATION# <19711 

THE ' EO • PROCESSOR IS AN OFF-LINE TEXT FOITOR OPERATING 
' UNDER THE EXFC-8 EXECUTIVE SYSTEM ON UNI V AC'S 1100 SERIFS 
COMPUTERS. FROM the: MANUAL'S EXPLANATION, 'FO' APPEARS 
CAPABLE OF OPERATING EITHER IN OFF-LINE OR ON-LINF HOPE. 

7101 05 CONTROL OATA CCRPORATION 

EDIT - KRUNOS TFXT EDITOR (EOITI REFERENCE MANUAL 
CONTROL OATA CORPORATION, MINNEAPOLIS, MINN (19711 
THIS REFERENCE MANUAL DESCRIBES THE ON-LINE TEXT EDITOR, 
•EDIT', PART OF THE KRONOS TIME-SHARING SYSTEM. 'EDIT* 
ALLOWS MERGING OF MULTIPLE FILES AND ELIMINATION OF ANY 
EXCESS BLANKS. IT HANDLES FILFS OF UP TO 250,000 LINES, 
EACH OF UP TO 150 CHARACTERS. 

710105 CONTROL OATA CCRPORATION 

KRONOS TFXT EL' I TOR (EOITI 
CONTROL OATA CORPORATION 

TEXT FOITOR ALLOWS THE USER TO EOIT A OATA FILE. THE OATA 
FILE BEING EDITEO IS KNOWN AS THE SEARCH FILE. 0UR1NG EDIT 
ING, THE SEARCH-POINTER IDENTIFIES THE LINF OF THF SFARCH 
F1LF THAT IS CURRENTLY ACCESSIBLE. THE SEARCH POINTER CAN 
BE MOVED FORWAPO ANO BACKWARD OURING EOIT INC TO SPECIFY A 
NFW LINE. 

7 1020 l SCHWAVDEP. K. 

CONVERSION OF LIMITEO-ENTRY DECISION TABLES TO COMPUTE 
PROGRAMS A PROPOSED MODIFICATION TO POLLACKS ALGORITHM 
COMM. ACM IMFEB 19711 ,69-73 

m.io IF 1CAT10NS ARC PROPOSED TO POLLACKS ALGORITHM, WHICH 
MINIMIZE SUBSEQUENT EXECUTION TIME WHEN COM°ILEO INTO A 
COMPUTER PROGRAM. 

710301 CHAPIN, N. 

PERSPECTIVE ON FLOWCHART PACKAGES 

COMPUTERS AND AUTOMATION 2C , 3( MARCH 19711,16-19. 

A COMPARATIVE STUDY OF VARIOUS AUTOMATIC FLOWCHARTING 
PACKAGES WITH RESPFCT TO FAC t ORS SUCH as SPFED, DESIGN, 
AND COST. 

7 1C 302 GEORGF, R.L. 

AUTOMATIC SELECTIVE DOCUMENTATION SERVICES 
NT I S-A0722925 

DOC HAS BEEN DEVELOPING ANO TESTING SYSTEMS BASED ON THE 
APPROACH UF DETERMINING USERS SPECIFIC DOCUMENTATION 
REQUIREMENTS AND AUTOMATICALLY 01 S SEM. I NAT I NG THE NEEDED 
DOCUMENTATION TO THE USERS' LOCAL LIBRARIES AS SOON AS IT 
OCCOMFS AVAILABLE. THIS CONCERT IS APPLIED TO THE 
SELECTIVE 01 SSEM I NAT I ON OF BOTH REPORT ANNOUNCEMENTS ANO 
FULL-TEXT Rf PORTS. 
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WILLIAM*, A g 

A SURVEY OF OATA STRUCTURES FCR COMPUTER GRAPHICS SYSTEMS 
NTIS-A0725286 

REASONS FOR USING OATA STRUCTURES ARE GIVEN. THE SEQUENTIAL 
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RANDOM, ANO LIST ORGANIZATIONS ARE DISCUSSED, AND IT ft 
SHOWN HOW THFY MAY BE USFD TO BUILD COMPLEX OATA 
STRUCTURES. REPRESENTATIVE SAMPLES OF LANGUAGES 
SPECIFICALLY OCSIGNED FUR C.RFAT1NG AND MANIPULATING DATA 
STRUCTURES AAF DESCRIBED. 

71C601 GUNDE RM AN , R.E. 

HARD LOOK AT SOFTWARE DOCUMENTATION 
J. SYSTEMS MGMT 21, 6( JUNE 19711,35-36. 

AUTHOR PROP OS F S A SET OF CRITERIA FOR EVALUATING PROGRAMMING 
DOCUMENT AT IUN IN ORDER TO ESTABLISH A BASIS FOR OVERALL 
IMPRUVEMFNT OF DOCUMENTATION. 

710602 BRACKETT, J.W. 

MAINTENANCE AND ENHANCEMENT OF THE AED SYSTEM 
DOC -AD3B T 1 A l 

ISEF A0R75395 FOR DESCRIPTION! 

710603 INTERACTIVE SCIENCES CORPORATION 

TECO - TEXT EDITOR AND CORRECTOR - REFERFNC E MANUAL 
INTERACTIVE- SCIENCES CORPORATION, eRAINT°EE, MA (1971) 

THIS PtrERCNCE MANUAL DESCRIBES BOTH BASIC A‘0 ADVANCED 
TECHNIQUES IN USING TECO ON A DEC POP-IP COMPUTER. THIS 
ON-LINT PROG P AM EDITOR ALICWS EDITING 70 BF QONF NOT ONLY 
BY SINGLE COMMANDS. BUT ALSO BY SMALL 'PROGRAMS' FOR MO«E 
COMPLEX EDITING. 

710901 ELLIS, T.O. 

ARPA NETWORK SFPIES I . INTRODUCTION TO THF ARPA NETWORK AT 
PANU AND TO THE RAND VIDEO GRAPHICS SYSTFM 
NT I S-AD733059 

AN OVTP VIEW OF THE ADVANCED RESEARCH PROJECTS AGENCY'S 

EXPERIMENTAL COMPUTFR NETWORK, and A TECHNICAL DESCRIPTION 
OF THT RAND VIDEO GRAPHIC SYSTEM THAT LINKS 0 AND COMPUTING 
RESOURCES INTO THE NETWORK. 


710902 


TUOOl 


T 11002 


WELLS, E.E. 

A LIBRARY OF DATA COLLECTION AND MANIPULATION 


SunoouTINfS . 


NT I S-A073A33P 

PROGRAMS Til ALLOW THE MINICOMPUTER TC PERFORM SOPHISTICATED 
OATA COLLECT ION, CONTROL, AND MANIPULATION FUNCTIONS IN A 
LABORATORY FKV1RUNMINT A°E P0 C SENT ED. THE EMPHASIS OF THE 
LIBRARY IS UPON FLEXIBILITY OF USE AND CASE OF CHAINING 
THF SUBROUTINFS TO MAKF DSFFUL PROGRAMS. IN ADDITION TP 
FLOW CHARTS WHICH INDICATE THF ALGORITHM, ACTUAL PROGRAM 


LISTINGS ARE PROVIDED. 


DEFENSE DOCUMENTAT IUN CENTER 

MICROFICHE, MICPOFILM, ANO RFLATEC EQUIPMENT 
NT | S-AU732BC0 

THIS IS A BIBLIOGRAPHY OF MICROFICHE, MICROFILM AND RELATED 
EQUIPMENT. ENTRIES HAVF BCFN SELECTFD FROM REFF J FNCES 
PROCESSED INTO THE AO DATA HANK FROM JAN. 196B T° JULY 
1571. 


KREUTZER, P.J. 

OATA COMPRESSION IN LARGE BUSINESS-ORIENTED FILES 
NT I S-AD73439* 
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711002 OAT A COMPRESSION IS OF INTEREST IN DATA PROCESSING BECAUSE 

IT OFFERS COST SAVINGS ANO THE POTENTIAL FOR INCREASED 
CAPACITY IN MASS STORAGE DEV ICES .CHANNELS AND COMMUNICA- 
TIONS LINES. ALSO THESE TECHNIQUES ARE REVIEWED AS THEY 
APPLY TO BUSINESS OATA FILFS ANO AN IMPLEMENTATION OF DATA 
COMPRESSION AN A BUSINESS TYPE DRUM FILE UNDER SFVERE CON- 
STRAINTS OF CORE, EXECUTION TIME, ANO COMPRESSION RFOUIRFMT. 

711101 tatman, j.c. 

ACHIEVING PROPER PROGRAM DOCUMENTATION 
J. SYSTEMS MGMT 21.11IN0V 1<J71), 40-41' 

A PROCEDURE IS PRESENTED FOR HELPING TC PRODUCE PROPER 

PRUGHAM DOCUMENTATION WITHIN AN ORGANIZATION. EMPHASIS tS 
PLACED ON ADOPTION OF STANDARDS. PROCEDURE INCLUDES 
MANAGEMENT APPROVAL, DEVELOPMFNT OF STANDARDS. ASSIGNMENT 
OF RESPONSIBILITIES, AND IMPLEMENTATION. 

7201CI SIGMA SOFTWARE COMPANY 

CFMS - CARO FILE MAINTENANCE SYSTEM 
SIGMA SOFTWARE COMPANY, GUT HP I F , OK, 1972 
THIS BROCHURE DESCRIBES THE THREE COMPONENTS OF THIS OFF- 
L INF PROGRAM EDITOR - AN UPDATE PROGRAM, AN INOFX REPORT 
GENERATOR, AND A RETRIEVAL PROGRAM. CFMS IS A TAPE- 
0° I CNTE 0 EOITOR OE VERY LOW PRICE AND RATHER LIMITED CAPA- 
B ILIT1ES. 

720102 USA F 

DOCUMENTATION STANDAROS 

DEPARTMENT OE THE AIR FORCE, COMMUNICATIONS COMPUTER 
PROGRAMMING CENTER, TINKER AFB, OKLA, 10 JAN 1972 
THIS DOCUMENT BRIEFLY DESCOIBES WHY DOCUMENTATION IS NEFOFD, 
DISCUSSES SYSTEMS FLOWCHARTS AND VARIOUS ANS REOU IP E W FNTS 
ON FLOWCHARTS. SAMPLE FLOWCHARTS AND A PROGRAM ABSTRACT 
APE INCLUDED. THE MAJORITY OF THE REST OF THIS DOCUMENT 
DEALS SPECIFICALLY WITH AIR FORCE IDENTIFICATION COOES AND 
IS OE LITTLE INTEREST. A PAGE OF DEFINITIONS OF COMPUTER 
TERMS IS INCLUOEO. 

720103 G'ODARO SPACE FLIGHT CENTER 

STANDARDS GUIDE FOR SPACE AND EARTH SCIENCES COMPUTER 
SCF TW A° E 

GUOUAPO SPACE FLIGHT CENTER, GR E ENBE LT , MARYL ANO , J ANUA» Y , 1972 
THIS DOCUMENT IS A SET OF GUIDELINES ECR DOCUMENTATION 
RECOMMENDED (BUT NOT REQUIRED) FOR USE AT GSFC. EMPHASIS 
IS ON LANGUAGE STANDARDS ANO APPLICATION OF GOOD 
MANAGEMENT TECHNIQUES. IT CONTAINS PROGRAMMING STANDARDS, 
DOCUMENTATION STANDAROS, TESTING AND ACCEPTANCE TECHNIQUES 
, CORRECTION ANO UPDATE STANDARDS. 

720201 C'JLLINANE CCRPCRATION 

PLUS D/A, A DIRECT ACCESS SOFTWARE SECURITY ANO CONTROL 

SYSTEM 

CULLINANE CORPORATION, BOSTON, MA, 1972 

THIS BROCHURE CTSCRiaES THE INPUT TO, OUTPUT FROM, ANO FCA- 
TUFES OF THE OFF-LINE PROGRAM COITOP. PROGRAM LIBRARY UP- 
OATE SYSTEM OIRECT ACCESS I PLUS 0/A). ITS PRIMARY SECURI- 
TY MEASURE IS A CHANGEABLE, SCRAMBLED CHARACTER SET. THIS 
PROGRAM ECITOR IS ALSO AVAILABLE IN A TAPE-OP IENT ED VfP- 
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720201 SION, KNOWN SIMPLY AS ‘PLUS'. 

720501 BUS INF S S AUTOMATION 

TALKING DOWN A PROGRAM 

BUS INF S S AUTOMATION 19.5IHAV 19721, 26r27. 

THIS ARTICLE DESCRIBES THE EXPERIENCE OF A SW PELL G°0 UP 
WHICH DICTATES COROL CODE INSTEAD OF WRITING IT LONGHAND. 
THE TECHNIQUE WAS FOUND TO INCREASE PROGRAMMER EFFICIENCY 
AND REDUCE ERRORS. 

7205Q2 PAN SOPH I C SYSTEMS. INC. ^ 

PANVAIET - THE DIRECT ACCESS LIBRARY SYSTEM 
PAN SOPH I C SYSTEMS, INC.. OAK BROOK, IL (1972) 

THIS PACKAGE CONTAINS AN OS USER REFERENCE MANUAL, AN OS 
SYSTEM MANAGEMENT MANUAL, AND AN EXTENSIVE SAMPLE OF THE 
OUTPUT TROM PANVALET. THIS UFF-LINE PROGRAM EDITOR SUP- 
PORTS UP TU 3 LEVtLS OF SECURITY CONTROL CODES AND ALLOWS 
TEMPJRARY UPDATING AND THE ^CAPABIL ITY OF CP JSS REFERENCING 
L IBRARY OATA SETS 

T205Q3 XERCX CORPORATION 

XEROX TEXT LANGUAGE ANO OPERATIONS REFERENCE MANUAL 
XERCX CORPORATION 

TEXT CONSISTS OE A CENTRAL XEROX COMPUTER (MODEL SIGMA 6,3, 
OR •>) OPERATING UNDER UNIVERSAL TIME-SHARING SYSTEM CuTSI, 
THE TEXT PROGRAM, AND ONE OR “OR* REMOTE TYPFWP I T C R TERM- 
INALS CONNECTED TD THE COMPUTER VIA TELFPHOnE LINES. 

720601 APPLIED DATA RESEARCH, INC. 

LI HRARI AN 

APPLIED DATA RESEARCH. INC., PRINCETON, NJ, 1972 
THIS PACKAGE CONTAINS A CONCEPTS AND FACILITIES r^R POP MAN- 
AGERS MANUAL, A USER REFERENCE MANUAL, AN OS SYSTEM REFER- 
ENCE MANUAL, AND A DESCRIPTION OF THE SPACESAVER DISK MAN- 
AGEMENT FEATURE. LIBRARIAN IS AN OFF-LINE PROGRAM TITPR 
WITH AN OPTIONAL CCi'UL SYNTAX CHECKER AND S'JMR ADAPTABILI- 
TY TO A CONVERSATIONAL TERMINAL OPERATIONAL ENVIRONMENT. 

720602 MANAGEMENT SYSTEMS CORPORATION 

PROGRAM/MAN AGE , A PF CG D AM TO MAINTAIN SOURCE PROGRAM 
MANAGEMENT SYSTEMS CORPORATION, DALLAS, T< ,, 

THIS BROCHURE DESCRIBES THE INPUT T 0 , , CAPAS 1 1 1 T I F S OF, AND 
OUTPUTS FRJM THE T API-PSI ENTCO OFF-LINE PRO',MA w r 01 TR 
1 PPOORAM/MAN AGE ‘ . DEVICF AND STORAGE R EQU IR E MR NT S AND 
COST ARE ALSO GIVEN. 

720603 AUERBACH ASSOCIATES, INC. 

DATA MANIPULATION 

AUERBACH COMPUTER TECHNOLOGY RF PORTS » SOFTWARE REPORTS, 51, 

( 1972), 6C07.P5-.e7, .91-. «3, .1C7-.1CB, 6P3P.129-.nl. 
THIS SECTION DESCRIBES THE INPUT TO, PROCESSING OF, AND OUT- 
PUTS CRUM THE PTE- LINE PROGRAM EDITORS ‘LIBRARIAN*. 

•PLUS D/A • , • SPL IS-I I ‘ , AND ‘SIMPLE* (WHICH StE). IT E.IVFS 
DEVICE AND STORAGE RE QUI R F MENT S. SOURCE LANGUAGE, COST, 

AND SPECIAL FEATURES OF EACH OF THE ABOVE PROGRAM EDITORS. 

720604 VAN-DAM, A. RICE, O.E. 

ON-LINE TEXT EDITING) A SUPVEY ^ 

I 

CO 

03 
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720604 ACM COMPUTING SURVEYS 3, 3 (SEP 19711,93-114 

THIS ARTICLE OISCUSSES THE ADVANTAGES OF ON-LINE EDITING OF 
BOTH COMPUTER PROGRAMS AND FPEE-FORM TEXT, THE DISTIN- 
GUISHING CHARACTERISTICS OF ThO TYPES OF ON-LINE 
EDITORS, AND THE CAPABILITIES OF SEVERAL WORKING SYSTEMS 
OF BOTH TYPES. A RATHER COMPREHENSIVE BIBLIOGRAPHY 
FOLLOWS THE ARTICLE. 

720605 COMPRESS, INC. 

CUMCHAR T 

C'IMPRCSS 

AUTOMATICALLY DOCUMENTS COBOL AND ASSEMRLEV SOURCE PROGRAMS. 

IT CAN ALSO HE USED WITH A SPECIAL DESIGN LANGUAGE TO HEL 
P IN PROGRAM DEVELOPMENT. COMCHAPT PRODUCES A DETAILED 
FLOWCHART AND A NUMBER OF CROSS-REFERENCES. 

72C606 M4NTECH CORPORATION 

SUPEREF 

MAN TFCH CORPORATION 

SJPFPFF AUTOMATICALLY PRODUCES A CROSS-PFFF RENC E LISTING OF 
F CH TP AN SOURCE PROGRAMS. NO FLOWCHARTS ARE GIVFN. 

T2C6F7 DATA F0= MANAGEMENT OECISION 

F JR TRAN VARIABLE NAME DCCUMENTER 
DATA FOP MANAGEMENT OECISION 

PRODUCES A SOURCE LISTING AND ALPHABETICAL LIST OF 
REFERENCED VARIABLE NAMES. 

720 6GB ON A SYSTEMS, INC. 

F JRFLO 

r ja systems, inc. 

FORFIU AUTOMATICALLY DOCUMENTS FORTRAN SOURCE PROGRAMS. IT 
PRODUCES OETAILCD FLOWCHART AND A RESEOUENCED SOURCE LIST- 
ING. 

7206C9 CALCOMP 

FLO wCEN /F 
CALCOMP 

FLDwiEN/F AUTOMATICALLY PRODUCES A DETAILED FLOWCHART FROM A 
FORTRAN SOURCE PROGRAM. IT PRUOUCES THE FLOWCHART ON A 
CALCOMP PLOTTER. 

720610 APPLICATIONS PROGRAMMING CO. 

DYNACHAOT 

APPLICATIONS PROGRAMMING CO. 

DYNACHART AUTOMATICALLY DOCUMENTS COBOL SOURCE PROGPAMS. IT 
PRODUCES A OETAILEO FLCWCHART AND A CROSS-REFERENCE LIST- 
ING. 

72C6I1 NATIONAL COMPUTER ANALYSIS, INC. 

QUICK-DRAW 

NATIONAL COMPUTER ANALYSTS 

QUICK-DRAW AUTOMATICALLY DOCUMENTS COBOL, FORTRAN, ANO ASSEM 
BLY SOURCE PROGRAMS, IT PRODUCES A DETAILED FLOWCHART, 
CROSS-REFERENCES, ANO SOME SPECIAL LISTINGS. 

T2C612 APPLIEO OATA RESEARCH 

AUTOFLOW 
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720612 APPLIED DATA RESEARCH, INC. & 

AUTOMATICALLY OQCUMFNTS COBOL , PL/ I , ASSEMBLY , AND FORTRAN 

SOURCE PROGRAMS. AUTQFLOW PROOUCCS FLOWCHARTS OF DIFFERENT 
LEVELS OF DETAIL, CROSS-REFERENCES, ANO MANY SBFC I AL 
LISTINGS. 

720613 BELOIT COMPUTER CENTER 

AUTOCHART 

RELCIT COMPUTFP CENTER 

DOCUMENTS CCBOL SOURCE PROGRAMS. PRODUCES A OETAILEO FLOW- 
CHART AND A CROSS-REFERENCE LISTING OF ALL LOBELS USED IN 
THE RRUCRAM. 

720614 AIRES CORP. 

AUTODI AGRA 1MER II 

AIRES CHRP. 

AUTOMATICALLY DOCUMENTS COBOL SOURCE PROGRAMS. PRUOUCES A 
OETAILEO FLOWCHART, A DIAGNOSTIC LISTING, AN ALTERED 
STATEMENT CROSS-REFERENCE, A RECORD LAYOUT, AND A UN w ATCHc 
D LABEL TABLE. 

720616 DATA INSTRUMENTS CO. 

AUTOOnr 

DATA INSTRUMENTS CO. 

AUTOMATIC DOCUMENTATION CF COBOL AND ASSEMBLY SOURCT PROGRAM 
S. PRODUCES A DETAILFD FLOWCHART AND CROSS-R E FFQ TNC F S. IT 
CAN ALSO OPTIONALLY PRODUCE A LOGIC CHART. 

720616 SYSTONmcS CORP. 

E2FL0W 

SYS TONE TICS COPP. 

AUTOMATIC DOCUMENTATION OF FORTRAN SOURCE PROGRAMS. PRCDUCFS 
A DETAILFD FLOWCHART AND CROSS-RE FER TNC ES. EEFLDW ALSO 
CAN RESEQUENCE SOURCE CODE LABEL NUMBERS. 

720617 TFXT SYSTEMS, INC. 

FRE SS USER • S GUIOE 

TEXT SYSTEMS, INC. 

f-KESS FILF RETRIEVAL AND EDITING SYSTEM) IS A SOPHISTICATED 
AND COST EFFECTIVE TEXT MANIPULATION SYSTEM. IT IS A VAST- 
LY ENHANCED, MULT I CONS CL E PRODUCT I JN VERSION OF THE PROTO- 
TYPE HES (HYPIRTFXT EDITING SvSTFM). IT IS AM ONLINE 
SYSTCM USING IBM 2741 FR 226 1 ' T EP" I NALS OR EQUIVALENT. 

T20701 ARPA NTTWORK INFORMATION C F N T E 0 

NETWORK INFORMATION CENTER USER GUIOE 

AUGMENTATION RESEARCH CENTER, STANFORO RESEARCH INSTITURE, 
MENLO PARK, CA, JULY, 1972 

CONTENT S: I. SAMPLE MESSAGE SENDING SESSION. 2. NIC TNLS USE® 
GUIOE. 3. NIC JOURNAL SYS TF M USER GUIDE. 4. LOCATOR. 5. PHONE 
SERVICE. 6. FOLKLORE DESCRIBES HOW TO USE T«E FACILITIES 

OF THE ARPA NF T wORK INFORMATION CENTER. 

720702 INFORMATION CONTROL SYSTEMS, INC. 

ASTROCOMP 

INFORMATION CONTROL SYSTEMS, INC. 

THIS SYSTEM PROVIDES TEXT FPITING CAPABILITIES ON MAGNFTIC 
TAPE. WIDE VARITY OF OPTIONS ARE ALSO AVAILABLE. 
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ABSTRACT 

This report is intended to acquaint the reader with features 
supplied by proprietary automatic documentation software packages 
currently on the market. A number of systems are listed with their 
corresponding purchase and rental costs, description of outputs, source 
languages processed, system environment, and in some cases sample out- 
puts of the system. 



3-2 


Table of Contents 


I. 

Introduction 

E-3 

II. 

Comparison Charts 

E-6 

III. 

Package Reports 

E-13 


AUTOCHART 

E-15 


AUTODIAGRAMMER II 

E-16 


AUTODOC 

E-28 


AUTOFLOW 

E-42 


COMCHART 

E-86 


DYNACHART 

E-97 


EZFLOW 

E-98 


FACTS 

E-105 


FLOWGEN/F 

E-112 


FORFLO 

E-115 


FORTRAN VARIABLE NAME DOCUMENTER 

E-116 


QUICK- DRAW 

E-117 


SUPEREF 

E-133 


FORDOC 

E-136 


IV. 


Suntnary 



INTRODUCTION 


Every data processing manager and programmer is familiar with the 
problem posed by the requirements for accurate program documentation. 

The preparation of this documentation has traditionally been time consuming 
and, consequently, it has often been set aside in order to allow the 
programmer to work on higher priority projects. 

The major goal inherent in any good documentation procedure is 
to construct a system for communicating a document's content to a 
human being. A well documented computer program enables user personnel 
to understand the program's objectives, its relationship to other 
programs in the overall installation, and its position in the system 
workflow. 

To relieve the programmer of much of the responsibility of program 
documentation many proprietary automatic documentation system have 
developed over the past few years. Many of these are generalized 
documentation packages which can accept source code as input and 
generate routines for computer analysis of the program requiring 
documentation as well as routines for producing reports on graphical 
representation that describe the program. 

To achieve a permanent record of the details of an existing 
program, the following program feature require documenting: 

1) Functional relation 

2) Cross-reference 

3) Furnish suitable cross-referencing facilities so that references 
to and from a given data element can be adequately presented. 
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Each cross-reference can be indicated on the flowchart at the 
place where the related element is mentioned, or a separate 
listing can be printed. A separate list has the advantage of 
furnishing all cross-references in a convenient format. 

4) Allow flexibility in the level of detail. A chart can be 
developed on a symbol-per-statement basis, or it can be presented 
as an overall picture of the program's functions. 

5) Convert comments in the source statements as well as other 
explanatory remarks into annotative flowchart statements. 

6) In the absence of explanatory remarks, generate the necessary 
annotations . 

7) Generate symbols that conform to accepted conventions or 
adhere to documented standards such as the ANSI standards. 

Some of the proprietary automatic documentation packages listed in 
this report contain all of the above features and more, while some simply 
give simple cross-references. The purchase and rental costs of these 
documentation packages are a function of the number of output features 
they list. Purchase price range from $175 for a simple cross-referencing 
documentation package, FXREF, to $7,000 for the AUTO FLOW system which 
contains possibly the greatest number of output features. 

The information for this report was obtained from the various 
software companies which produce proprietary automatic documentation 
software packages and from the Auerbach Computer Technology Reports. 
Letters requesting information on particular software packages were sent 
out to thirty five software companies. Of these original thirty five 
requests, about fifty percent of the companies responded. 
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A second letter was sent out to those companies who did not 
respond to the first letter. Less than fifty percent of these companies 
responded to the second letter. 

Some of the information which could not be obtained from the software 
companies which produced these automatic documentation packages was 
supplemented by the Auerbach Computer Technology Reports. 
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COMPARISON CHARTS 
Introduction 

The following charts present many characteristics of existing 
documentation packages. These charts are intended as a guidance 
for comparing available documentation packages. Quick comparisons 
may be made through the use of the charts, and further information on 
a particular documentation package can then be found in the Package Reports 
section of this report. 

The charts are divided into two major sections: 

System Requirements 
Characteristics 



SYSitn REQuikEMEiiis 
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^'\£ACKAGE 

FEATURE 

AUTOCHART 

Beloit Computer Center 

AUTODIAGRAMMER II 
Aires Corp. 

AUT0D0C 

Data Instruments Co. 


Svstem 

IBM 360/25 

jm | 

any capable of 
COBOL support 

/> 

•v* 

Main Storage 

32K 

52K 

28-64K 

LU 

E 

LU 

XT 



Disc 

Magnetic tape or disc 

— » 
D 
O' 
LU 
Cd 

Input/Output 

card reader/ 
punch, printer 

Disc, Cardreader, 
Printer 

line printer, card re§der 
disc, taoe 

Z 

U 

Cper;ting System 

DOS ,0S-MVT 

DOS, OS 

any capable of COBOL 

SUDDOrt 

to 

>* 

to 


(not available) 

Assembly Language 

COBOL and IBM assembly 


Package Ty r -e 

Program Documentation 
detailed flowchart, 
cross-reference listing 
of labels 

Program Documentation; 
detail flowchart, or high 
level. 

cross-reference lists, 
logic charts, 
label .cross-reference, 
unmatched label tables, 
record and report layout 
souffe listina 

Documentation Aid; 
cover page, 
source list, 
error list, ’ 

report and record lay-- 
out,- 

cross-reference list, 
detail flowchart, 
brief logic chart 


Logic Flow 
Presentation 

Detail flowchart at 
same level as source codf 

Detail flowchart at sourc 
code level ; 

variable symbols: contain 
source codes, 
flow is vertical and 
page formatting is 
available. 

high-level logic chart 
ill .par. relationshi ps 

5 narrative description 
from source comments, 
detail flowchart with 
ANSI or IBM symbols 
same level of detail as 
source code, 
depicts page, connector 
no. of referenced stats 
ments and referencing 
statements, 
logic chart oepicts 


Cross References 

shows location of each 
label in the flowchart, 
location of each label 
that branches to that 
statement 

Paragraph cross-reference 
in high-level logic 
chart ; 

Label cross-reference 
table, 

Altered Statements 

Unmatched unreferenced 
labels 

. statements that affect 
* only loqic flow 

to 

J 
— « 

y> 

cc 


listing of data items , 
procedure names, ext. . 
hames , li terals ,fi gurati' 
constants , system names 
alDhanumeric ordering 
gives label type, defin- 
ing and referencing 
source code number 
also on detail flowchart 


Man-Machine 

Interface 

Input-card reader 
Output-printer 

Input-card reader 
Output- printer 

Input-cards, disc, tape; 
can input up to 99 
programs in batched made 
from card reader or fron 
system librarv 


Cost 

Purchase - $950.00 
Rental - (none) 

Purchase - $3,200 
Rental - (none) 



Purchase - $4,800 

(3-yr lease) 
Rental - (none) 


Source Programs 
Processor 

COBOL 

COBOL 

FORTRAN. , 

SAL * optimal 

COBOL 

IBM assembly 


Comments 


Two phase system; flow- about 20-30 installations 
charter, cross-referenc- 
ing 


about 50 installations 
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^ s ' s *s*£ACKAGE 

FEATURE 

AUTOFLOW (1964) 
Applied Data Research 

C0MCHART 

Compress 

DYNACHART 

Applications Programming 
Co. 


System 

IBM 360,1400; RCA Spectra 
70;H200 

IBM 360/370; RCA Spectra 
70 

any with COBOL Compiler 

10 

K— 

Z 

LU 

2C 

LiJ 

o: 
►— « 
ID 
O' 

UJ 

or 

Main Storage 

Support for GS,D0S,T0S, 
TDOS 

65K bytes 

30K character 

IRiHHHIH 

System residence device 

4 sequential files 

1 disc or 4 tapes 

Input/Output | 

card reader, tape, disc, 
line printer 

card reader, tape, disc, 
line printer 

i/0 - card reader, 
printer disc, tape 

y 

LU 

H- 

w 

>- 

on 

Operating System 

OS ,D0S ,T0S( IBM 360), 
TDOS(RCA) 

0S,T0S,TD0S 

any with cobol compiler 

Sr- ire;- Language i 

Basic Asseniily Lanquaae 

COBOL and Assembly 

COBOL 

on 

o 

»H 

H* 

CO 

cx 

iu 

K 

U 

«X 

c: 

< 

u 

Package Type 

* 

i 

Documentation aid; 
generates a flowchart 
used for debugging 
summarizing an existing 
system 

constructing a preimple- 
mentation flowchart 

Documentation ai diprodu- 
ces a flowchart, deck 
listing, a cross-refer- 
ence index of element 
names ;al so a design 
language for developing 
programs 

Documentation aid which 
produces flowchart, 
diagnostics, cross- 
references ■ 

Logic Flow 
Presentation 

In form of text and flow- 
charts ; 

flowchart at same level 
as source code, 
distinct units for pro- 
cessing blocks, 
page. source card, symbol 
(box) nos. 

on and off-page connect- 
ors 

Standard symbols used in 
flowchart;built in cross 
references Retailed 
analysis of each state- 
ment 

Flowcharts at same 
level of detail as 
source code separate 
page per subroutine; 
paragraph not split 
between logical pages 

Cross Reverences 

Table of contents and 
references incex pre- 
ceeds flowchart and con- 
tains cross-referencing 
information 
Listing of COBOL data 
names in alphanumeric 
order with page, flow- 
chart box ?,and source 
sequence §. 

alphabetic index of all 
elements 

outline of procedures, 
listing all incoming 
and outgoing references 

Labels alpnabetically 
listed as are defining 
source code sequence 
number and all state- 
ments referencing label 

Man- Mac nine 
Interface 

Input - card reader 
Output - printer 

Input - card reader, tape 
disc 

Output - line printer 

Input - card, tape, disc 
Output - printer 

Cost 

Purchase - $3,000-7,000 
Rental - per installatior 
basis 

Purchase - (none) 

Rental - $2,425 (1 yr); 
$4,225 (10 yrs) 

Purchase - $4,400 
(1st yr) 

Rental - $700/yr after 
1st yr • 

Source Programs 
Processer 

COBOL 
PL/ 1 

Assembly 

FORTRAN 

COBOL, Assemble, 
Design Language 

COBOL 

Common ts 

About 1400 installations 

Tver 50 installations 

About 45 installations 
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PACKAGE EZFLOW 

Systonetics Corp. 


FACTS FLOWGEN/F 

Bonner & Moore Asso. ,IncJ^ a ^ com P 



IBM 360, CDC 6000 Series Isigma 7 



Main Storage 


Auxilary Storaoe f 10ne 


card reader,tape, or 
Input/Output disc, line printer 


Operating System 0S( IBM) ,SC0PE(C0C) 


Not Available 


Not Available 


ot Available 


{Not Available 


Iriot Available 


Card reader, tape, printer 

taoe 


Not Available 


Package Type 


Logic Flow 
Presentation 


FORTRAN IV 


Documentation Aid that Documentation aid; 

? enerates cross referencing 

lowchart 

input/output source 
deck 

a cross-reference list 
statement reference 
table 


flowchart at same level None 
as source code; up and 
down single-col flow; 



Not Available 


Program Documentation 
Detailed Flowchart 


Detail Flowchart 


Cross References Listing of statement 
labels and references 
to show old and rese- 
quenced source code 
label numbers and 
source list line number 


Six reports are given; (none) 
common report, local 
report, format statement 
statement label report, 
recap, global report 


Sj ;.an-i.icnine 
Interface 


Input-card reader, tape. Input-card reader, tape Input-card reader, drum, 
or disc Output-printer, tape disc, or tape 

Output-printer Output-CalComp Plotter 



Comments 


Purchase - $1,750 
Rental -(none) 


Source Programs FORTRAN 
Processer 


Purchase-Not Available 
Rental - Not Available 


Not available 



under 10 installations t; 0 t Available 


Not Available 
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PACKAGE 


Main Storage 


Auxilary Stor 


Input/Output 


Source Lo-ti* re- 


package Type 


Logic Flew 
Presentation 



F0RFL0 

DNA Systems, Inc. 

FORTRAN VARIABLE NAME 
D0CUMENTER 

Data fpr Management 
Den si on 

IBM 1130/1800 

Designed for user's 
conn - quration 

1 1 30 (8K core); 1800 
(10K variable core) 

Capable of. supporting 
FORTRAN compiler 

T ' 

1 disc 

1 disc 

disc, card reader, line 
orinter 

Card reader, line printer 

Monitor, TSX version, 
MTX 

Speci fi c system not 
requi red 

Assembler 

FORTS AM... a nd .Subroutines. 

FORTRAN 

Documentation package; 
gives flowcharts and 
resequenced source 
listing 

Documentation tool -.source 
list, and alphabetical 
list of referenced 
variable names 

Flowchart at same level 
as source code, source 
statements within block: 

(none) 

(none) 

Sequence number of all 
statements that referenc ? 
each variable name 

Input-cards or disc 
Output-printer or disc 

Input-card reader 
)utput-line printer. 

Purchase - $480(cards); 

$600(disc) 

5 urchase-$350(object) ; p 
$500(source) j 

FORTRAN 

: 0RTRAN : 

1 

Resequence listing 
arranges source state- 
ment label nos. by 
fives. about 63 install . 

ibout 6 installations 


QUICK- DRAW I 

National Computer Analysts 


Any with COBOL compiler 


32K bytes ( DOS ,T0S);65K 
bytes (OS 


System residence device 


line printer 


any with COBOL compiler 


COBOL . Assem 


Documentation aid 
source programs into 
flowcharts elates cross- 
references 

diagnostic checklist, . 
modifies instruction 
list available for de- 
bugging 


i un i a j u a U Gallic level 

as source code 

uses symbols, text, flow- 

connectors .reference 

information 

each element of chart 


statement nos. or tag 
double-Daoe format 


Referencing descriDed by 
flowchart coordinates & 
source code no. 
Iross-reference tables 
include data-defined 

XI pAaEeti c listing of 
.tag names procedural 
statements and all sub- 
routines 

data and procedure name 
rocedural logic 


nput-card reader, tape, 
disc 

utput-printer 


urchase - none 
ental - $1 ,400-3,100 
(lyr); $1,900- 
6 , 300 ( 3yrs ) 



UICK-DRAW is being 
used at over 400 

installations 
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PACKAGE 


•'EATURE 


System 


SUPEREF 

Mantech Corporation 



FORDOC 

J. Toellner & Asso. 


not Available 


Main Storage 


Auxilary Storaae 


Not Available 


Not Available 


Input/Output I Card reader, printer 


Operating System Not Available 


Source La- 


Package Typ 



Not Available 


Documentation Aid 


Not Available 


Not Available 


Card reader/punch ,printe 


Not Available 


Not Available 


Program restructuring & 


Cross-reference listing documentation ' 

Cross-reference listing 
and restructured source 
deck. 


Logic Flow 
Presentation 



Cress References Produces a comprehensive Variable name cross- 
symbolic name reference. 

Cross-reference dictionai 


Man-Machine 
ui Interface 



Not Available 


Not Available 


Source Programs FORTRAN 
Processor 


Comments 


Not Available 


Input - cardreader 
Output - printer, card 
punch 


Not Available - Purchase 
Not Available - Retail 



Not Available 
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PACKAGE REPORTS 
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PACKAGE REPORTS 
Introduction 

This section contains information on documentation aids packages 
currently available to the data processing market. Sample outputs 
are given for a number of the packages. 

Each report has two major sections: 

GENERAL - In this section features such as package purpose, 
system requirements, pricing, and source languages 
processed are given. 

PACKAGE OUTPUT - This section lists the various outputs 

that the particular package gives. A description 
of each output is also given. 
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AUTOCHART 

Beloit Computer Center, Inc. 

GENERAL 

AUTOCHART accepts COBOL source programs as input and produces a 
detailed flowchart and a cross-reference listing of all labels used 
in the program. These two phases can be run in one jobstream or they 
carcbe executed as separate programs. 

The minimum configuration for using AUTOCHART is an IBM System 
360 Model 25 on up with a 32K central processor, one disk storage file 
(2311 or 2314), one card reader/punch, and a line printer. A magnetic 
tape drive is optional if you wish to execute the two phases in one 
jobstream. The system operates either under DOS or OS-MVT. 

AUTOCHART is a low cost system with limited capabilities. The 
purchase price for AUTOCHART is $950.00 complete. 

PACKAGE OUTPUT 

Flowchart - A detailed flowchart is given. 

Cross-Reference - This listing shows the location of 
each label in the flowchart as well as the 
location of each label that branches to that 
statement. 


(No output examples are available) 



3-16 


AUTODIAGRAMMER II 
AIRES CORPORATION 

GENERAL 

AUTODIAGRAMMER II is used as a documentation aid and as a debug 
tool for COBOL source programs. Standard outputs are a detailed flow- 
chart, a diagnostic listing, an altered statement cross-reference table, 
a record layout, a source listing, and an unmatched label table. 

The package can be implemented on any IBM System/360 configuration 
capable of operating under DOS (Model 30 and up) with 64K bytes or OS 
(Model 40 and up) with 128K bytes. DOS requires a 2111 or 2314 disc; 

OS requires any direct access device. Additional requirements are one 
card reader and one printer. AUTODIAGRAMMER II is written in 360 
assembly language. 

Purchase price of the package is $3,200. 

PACKAGE OUTPUT 

The detailed flowchart is given in which each statement is displayed 
with a separate logic block. User can select one or two logical pages 
per physical page, margin size, and six or eight line-per-inch printing 
density. All symbols are of variable size. Processing comments associated 
with each source code are included within its corresponding flowchart 
symbol. Narrative source code comments are printed in-line and are not 
enclosed within symbols. 

The diagnostic table lists all error the diagnostic error codes, 
the statements in error, the location of each statement in the detailed 
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flowchart and the error code associated with each mistake. 

The al tered Statement Cross Reference listing displays the paragraph 
names and flowchart locations of the statements being altered, the 
location of each altering statement, and the name and flowchart 
location of each destination. 

The hi,gh level logic chart displays the relationships between 
paragraphs in the program. 

The input/output chart shows each file name, unit assigned, record 
name, and input or output relationship to the program. 

The label cross-reference table displays each label by name, location, 
and sequence number and gives the flowchart location of each reference 
to the label by statements in the program. 

The record layout graphically displays each record defined in the 
program with its field and sub-field name, length, and type specifications. 

The sample report page displays a sample printed page that would 
result from the Report Definition Section of the user's program. 

The source listing shows all the source statements and remarks as they 
appear in the source deck. 

The unmatched label table displays each label which is defined 
but never referenced, and each label which is referenced but never defined. 
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Figure 4. Diagnostic Table and Error Codes 
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*• High Level Logic Chart. 

The High Level Logic Chart illustrates the rela- 
tionships between the paragraphs in a COBOL program. By 
xntraying the linkage of process blocks, this chart assists 
the programmer in visualizing control transfer patterns and 
reviewing them for accuracy. 

Each paragraph in the source program is shown 
with its name and flowchart location in a processing block. 


The processing blocks are listed in the order of appearance 
in the source program. They are connected by vertical lines 
whenever the preceding paragraph is not an EXIT or GO 
TO paragraph. To the left of each block are listed any 
paragraphs which transfer control into the block. To the 
right of each block are listed any paragraphs to which the 
block may transfer control. Figure 5. illustrates the format 
of the High Level Logic Chart. 
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•mnsrers Id 


MI6M UVU U6IC CHART 
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Figure 5. The High Level Logic Chart for the 
program in Appendix * A”. 
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Continuation of Figure 5. 
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Figure 6. The Input-Output Logic Chart, 
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Figure 7 shows the Label Cross-Reference Table 
produced by AUTOD1AGRAMMER 11 using the source 
| >gram in Appendix “A”. 
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Figure 7. Label Cross-Reference Table 


The use of the Label Cross-Reference Table in 
Kecking transfer instructions is shown in Figure 7a. This 


kind of step by step analysis is applicable to labels which 
are referenced in the source program. 
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Contim . l»on of . 3. 
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g. Sample Report Page. 

When a program has been written using the 
COBOL Report Writer Feature, the programmer may re- 
quest that AUTODIAGRAMMER II produce a sample 
printed page of the report. This output would show the 


report exactly as it is established in the Report Defin 
Section of the User’s Program. 

A sample report is given below. 
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Figure 9. Unmatched Label Table. 
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AUTODOC 

DATA INSTRUMENTS COMPANY 

GENERAL 

AUTODOC accepts COBOL source code and, when implemented on an 
IBM 360, will also accept assembly language source code. AUTODOC 
generages a cover page, a source program listing, and an error list. 

At the user's option it can also generate a document for describing 
report (COBOL only) and record layouts, for listing Data and Procedure 
cross references, and for creating both a detailed flowchart and a logic 
chart. AUTODOC can process programs individually, or it can process up 
to 99 source programs in the batch mode. 

AUTODOC can operate on the following systems: Honeywell 200 
central processor with 28K characters of core, IBM System 360 (model 25 
and up) configured with a 48K problem program partition and capable of 
operating in a DOS or OS environment, CDC Series 3304 or 3504 central 
processor with 32K words of core, and NCR century 100 or 200 with 32K 
core, and a Burroughs B 5500 with 64 K core. AUTODOC is written in 
COBOL. 

Cost for AUTODOC is $4,800 for a 3-year license agreement for the 
first customer installation. Each additional installation of the same 
language costs $2,500. Separate AUTODOC packages for processing COBOL 
and assembly language can be purchased and the package for processing 
the second language costs $1,800. 
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PACKAGE OUTPUT 

The cover page gives the name and author of the program. It also 
gives information describing the program's hardware environment, 
security status, and origination date. The remarks section can give a 
complete narrative description of the program. 

The source program list lists the statements processed along with their 
sequence number. Thus number can be used as a reference number late 
by autodoc. 

The error list gives certain syntax errors found. It lists the 
statement in error and the sequence number of this statement. 

The report layout (COBOL only) is provided for all reports defined 
in the Report Section. 

The data reference list (COBOL only) lists all data items used in 
the program along with information pertaining to each of them. 

The procedure reference list (COBOL only) lists alphabetically all 
procedure names used in the program along with its associated source 
sequence number. Also given are the page connector number of the flow- 
chart connector symbol generated by the procedure name and the 
source sequence numbers of statements which reference it. 

The special reference list (COBOL only) lists all source sequence numbers 
referencing an external name, a literal, figurative constants, and system 
names . 

The label reference list (assembly only) gives an alphabetical listing 
of all labels defined within the CSECT or DSECT bring processed. 

Their associated sequence number is also given. Additional entries 
include the page and connector symbol generated by the label, and the 
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source sequence numbers of all statements that reference that label name. 

The det ai 1 f 1 owch art p ro vi de s a two-dimensional representation of 
the logic flow. It constructs a symbol for each source statement and its 
related text. The user can select ANSI Standard or IBM flowchart symbols. 
Each flowchart logical page is divided vertically into four position 
segments, with flow direction from top to bottom. The flowchart can be 
printed as one or two physical pages per logical page. Both offpage and 
onpage connectors are generated. 

The logic chart (COBOL only) charts only statements which affect 
the logical flow of the program, as well as statements of the notes and 
input/output type. 
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AUTOFLOW 


APPLIED DATA RESEARCH 


GENERAL 

AUTOFLOW translates source language programs, written in COBOL, 
FORTRAN, PL/1, assembly language or numerous autocode languages, into 
flowchart documents in various levels of detail. This includes statement 
analysis, page allocation, line drawing, and rearrangement of source in- 
put as necessary. 

The package runs on IBM 360 Series (under OS, DOS, TOS), IBM 1400 
Series, IBM 7090 Series, RCA Spectra 70 Series (under TDOS), Honeywell 
200 Series; requires one tape or disc and printer, microfilm, or plotter. 
AUTOFLOW is a single, multiphase program written in BAL. 

A permanent license costs $3,000 to $7,000 depending on the language 
features required. 

An unlimited monthly usage license is priced at a flat monthly rate 
depending on the language features required. 

PACKAGE OUTPUT 

The AUTOFLOW chart set is produced which includes: 

Title Sheet - This listing contains the program name, date, 
and other pertinent information. 

Input Listing - This printout contains a complete 80/80 
listing of the input program. 

Procedural Statement Label Index - This listing specifies 
appropriate section and paragraph names, 
labels, or statement numbers in alphabetic order 
and provides a quick reference between the source 
program and the flowchart. 
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Table of Contents and References - This cross-reference table 

provides indexing information for locating transfers 
of control, both within the flowchart and the 
source program, whether the references are 
explicit or implicit. 

Table of Diagnostics - This listing contains a record of logical- 
flow errors, incomplete paths, missing references, 
and other programming errors. 

Flowchart - Each flowchart covers two consecutive printer 

sheets and can contain up to four columns of flow 
paths. The symbols on each page are numbered 
consecutively. 

SPECIAL LISTINGS FOR COBOL ; 

COBOL Diagnostic Analysis - Analysis of the COBOL program is 
performed identifying logical flow errors, 
as well as syntax errors. 

Procedure Division Analysis - Provides a summary of the various 
vital activities which take place in the Procedure 
Division. 

Data Division Analysis - (Data Cross Reference) shows the 

flowchart locations and source sequence numbers 
for each data name reference in the program. 

Data Record Map - Presents a descriptive layout of all group and 
elementary items in the records within all sections 
of the Data Division. 
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Data Division Index - Contains all data and mnemonic name 
items sequenced alphanumerically , as well 
as pertinent information for each item. 

High Level Flowchart - The COMPRESS facility of Autoflow system 
enables a user to control the level of flowchart 
detai 1 . 

SPECIAL LISTINGS FOR ASSEMBLY : 

EQU Statements - A chronological collection of special symbols 
to represent all EQU statements used in the 
source program. 

Constants and Storage Areas Listings - A listing of all constants 
and storage areas. 

Modified Tag Summary - A listing of all modified tag references, 
as well as their location. 

Litera l Summary - A listing of all literals used in the source 
program as well as the sequence number in which 
each literal appears. 

Macro Usage Summary - A listing of all macros used in the program, 
of where they were invoked, and of where the 
applicable definition is located. 

SPECIAL LISTINGS FOR PL/I; 

On-Unit Action Blocks - Statements which comprises interrupt 
condition specifications are flowcharted as 
separate units. 

Called Procedures Cross Reference - This chart provides a 

summary display of all CALLED entry points in the 
source input. 



3-45 


Signalled On-Unit Action Blocks - This chart graphically 

represents all signalled interrupt conditions and 
their points of reference. 

Label Assignment Cross Reference - This is a chart to illustrate 
** the effect of label variables used in 60 TO 

statements on the logical flew of a program. 

Duplicate Declaration Map - Multiple declaration of an 
identifier are listed. 

Condition Prefix Map - This illustrates the physical placement of 
condition prefixes within the nested procedures 
and BEGIN blocks in the source input. 

Declaration Statements - This listing displays non-procedural 
declaration statements in the order of their 
appearance in the source input. 

GET/PUT, FORMAT Statements -These type statements are printed 
in this listing. 

Note: Each language has the CHART option which enables the user to control 

the level of detail in the flowchart. 

Comment: Autoflow seems to be the most complete and successful proprietary 

automative documentation package on the market today. It by far has 
the most installations of any of the documentation packages, and 
has more features than any other package. 
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INPUT LISTING 


autoflow chart SET - sample standard cobol 


COBOL NODULE 
CARn NO 


»L I if l ,*&HS3,P»«NI 


10 

11 

1? 

13 

11 

15 

IT 

11 

10 

20 

21 

2? 

23 

?4 

25 

26 


20 
TO 
31 
3? 
33 
3*. 
3 S 
36 
3T 
38 

30 


51 

5? 

$3 


60 

SI 

62 

63 

6* 

65 

66 

67 

68 

w 

T 1 

Vy 

74 

11 

77 

78 
70 
30 

H 

B 3 
84 


88 

80 

00 

01 

02 


11 

98 


01 

02 

03 

04 

05 

06 
107 

08 

0 ° 

1 ? 

12 

13 

14 
18 
16 

17 

18 
|0 
20 

1! 

24 

28 

II 

i; 

30 

31 

32 


I 34 

135 

136 

II! 


r u ,,r,- A „ PR D’lCED F R ON COBOL SOURCE INPUT 

MV ,kl F,vF t M f iisuv. of the sourcf 

J S r u !* T V F T a M3 f O p l 'NT I MS AM CROSS 8 I FCRtNfl LISTING. 
!"'** ^ 1 ICS. A •P.fMAWKS' PORTION AN 0 THEFl6w 

program! nuc “° H ™ f p1 ocfduri division of the source 

! H £ LISTING OF THF SOURCE INPUT is OPTIONAL. SFLEfTFO RV 
PARAF'ETFN CAC|). THE INPUT l|$T OPTION 
P«OGRAH. RfEN lNV0,tfcn F0< * ,Hh AUTOUOW CHARTING OF IM|$ 


f^^PNTS INOICATFS THF CHART LOCA 
fAfH SfC T lfN 116 P A R AG P A n H WITHIN THE PRDSP AN A 



oSSI T R? " ” ; If : l PS p ,-,Tl ? « ?T5 P • ''F' • c "OM -VC s 

000? >»0 IT. MTR-SANPIF. 

000 TJO Ailin''*, wlf*. 

oU',% MllliltllR: ::i7f'I7\:s:**« ctN,E '- 

OOO600 ! Tli.f-.iMttn i> f TDI’AY 
000601 Mf'ARKS. AN JUtJFLGw'f MAPI PR 

000602 ' - - 

000*03 
000604 

00 060 s 

000*04 
000607 
000608 
000609 
0006 1 0 
000610 
000611 
000612 
00061 3 
0006 1 4 

00061 5 
000616 
000617 
000618 
000bl« 

0006’0 
000621 
000622 
00062? 

000423 
000624 
000625 
0006*6 
000677 
000628 
0006?P 
000629 
000630 
0004 31 
000632 
000633 
000634 
0006*5 
0006 1 6 
0006 37 
000638 
0006 39 
000700 
oooeoo 

000910 
001030 

0011J0 ENVIRONMENT DIVISION. 

001700 f ONriGUR ATION SECTION. 

001300 SOU'Sf E-f ONPjTf A. IBM-360 F30, 

001400 ^8 J c Cl -COM PUT ER . IBM-360. FJO, 

001500 % 

001600 INPUT-OUTPUT SECTION. 
ooiToo hi'-conttoi . ^ 

001800 SELECT TRANS-IN 

001000 SELECT ‘ 

0020U0 SFlCCT 

002100 

00? 2 JO nATA DIVISION. 

002300 file SECTION. 

002400 *0 MASTER-IN 

002530 ' 

007600 
0027 >0 
002800 


T ION OF 
AS WELL AS 


i^ftJ f D f: !, Sll)NS ' those’ DECISIONS WHOSE PATHS CCNF 
NAME FIELD * EXT SENTENCE', ABE INDICATED WITH A 


WHEN PR F SENT* THE • RE N ARK S* STATFMpNT IN THF 
MAPoIiiur AT L r ? N r 0 I V I5 , 9 N UlLL APPEAR AS INTRODUCTORY 
narrative, in the te*t foumat of an autoflow flow chart 

ruADt S T AT t Mf NT IS PRESENT, THIS NARRATIVE 

PRESENT. the MATERIAL CURRENTLY BEING 
CH4RT" 0 s 4n e . XAHPL£ of ™ F ' Rfc MARK S' STATEMENT NARRATIVE 

f*CH PROCEDURE DIVISION • SECT ION* PRO0UCES A CHART. WHOSE 
CHART TITLE IS THE S^CTI^N NAME, THIS CHART T ■ fi c ippr to c 
CFrrVfiiuVc A 2o^r rS f FfiCM F C c * CHART PAGE PRODUCEO^FOR TM|$* 

5 F C T I ON S PROCEDURES. AS EACH SECTIGN bcC IMf S A CHART. 

T»Blf L o“ CONTENTS?* “ NV SEC,I0N ' ,4r 61 LllCalEO FRO* THE 

A . P n?9?.J* I Hp L I E S A BRANCH FROM ONE SECTION TO THF 
NEXT, A BRANCH SYMBOL IS GENERATED IN THE FLOW CHART* 

This PROGRAM is INTENDED only as a SAMPLE OF A PROGBaw 
“’JICH MIGHT 8 F Run unofp autoflow. IT probably is not 
SUBJECT ru CLOSE SCRUTINY fQR LOGICAL PROGRAM CAPABILITIES* 


TRANS-IN ASSIGN TO • SYSOI 1 * • 
MASTER-IN ASSIGN TO *SYS012»* 
MASTER-OUT assign to •stsom*. 


002900 01 MASTIN, 


003000 

003100 

003200 

003300 

003400 

003400 

003400 

003700 

003MUC 

003930 

00*010 


W> T i ,N V°°0 CH4R4CTFRS 
RfC'.RO CONTAINS 100 CHARACTERS 
LABIL R'CCPOS APf STANDARD 

are mastin. 

PICTURE IS X f 101 • 
PICTURE IS *121. 

P JCTURf IS XI 161 • 


004100 F D M AST ER-OG’T 


0? MASTIN-««Y. 

03 INACCI “■ 

35 I NT v °E 

03 I N° F f PICTURE IS 
03 INCOng PICTURE IS 
02 MASTIN-NAME-AD3RESS. 

03 INNAMF PICTURE IS XI26I. 

M'WAESS PICTURE IS XI23T. 
03 INCITY P!CT-|Rp IS XC15I. 

0} _p^cjuRC||s_xi|!: 


03 I N2 I P 


x 151. 


004200 
004300 
004400 
004400 
004600 01 
004 700 
004800 
0049U0 
005000 
0041 00 
005700 
005 300 
005400 
005400 
005700 

005800 _ ... 

005900 FO TRANS-IN 
OO6CO0 ----- - 
004100 
006200 
006*10 
006400 01 
006500 
006400 
C06700 
006500 
006°00 
00 7000 
OO 7100 
007200 
00 7 300 
00 74 00 
007500 
007610 

007700 hOAKt NO-STPRAC.r SECTION, 

007800 77 PRf V-Ma ST I N PICTlJ®f 

007*00 77 •'»£ V- MA ST GUT 1 

008000 *7 PPEv-tKANSlN 

0081 OO 77 Eil“*iw PICTURE IS * VA( tjF 14 cp»fc 
00°7t»Q 77 nilTAfi^A-Sw PICTlJBC IS X VALUE IS SPACE 
0 08 *00 77 F.i'C-e-ftpr PJCTuRE $ X(40). S >P*Ct. 
0.1P4C0 J1 CuRR-MAS! IN. *1405. 


ie?^5r> c r^. T ? ,, i ,s . ?0 ' 30 characters 
??£?. a0 oSS NT 5 ,NS 100 characters 

LABEL RECPWOS AR.F STANDARD 
MAsrr*»T EC0B0S 40E ^* STQUT * 

02 MASTOUT-AEY. 

03 OUIACCT PICTURE IS XllOI. 

03 OUTyPE PICTURE |S X 2 1, 

03 OUTOfcF PICTURE IS X116I. 
^,03 OUT CODE PICTURE IS X. 

0? MA STOUT-NAMF-AIDPfSS. 

03 OUlNAM£ PICTURE JS XI26I. 

03 ruTAUORISS PICTURE IS XI21I. 
03 PUTCITY PICTURE IS XII51. 

03 HuT ST AT f PICTURE IS > 

03 0UT2IP PICTURE IS XI5I. 

?co ° characters 

F f^ R 0 CONTAINS 100 CHARACTERS 
DATA PEC PROS A»E TRANSIN 
T JA8FL^BfCl>«»'JS ARE STANDARD. 

02 TPANSIN-XEY. 

03 TRACCT PICTURE IS 

03 TRTYPE PICTURE IS 

03 JPEF PICTURf fS 

03 T1C3PE PICTURE IS 

0? 1 PANS- NAME -A0L* 3 E SS . 

03 TRNAMf PICTURE IS 
03 U’ADDMf-SS P|CTU«C . , „ , . 

03 IRC! TY PICTURE IS X1I5I, 

03 TRSTATE PJClUR* IS *|> * 

03 1R2IP PICTURE IS xjsf. 


XllOI. 
KI2I. 
XI 161. 


>1261. 

IS X123I. 


PICTljPf K X | 36 I . 

?i?r.2p II.IIC!: 


0084 00 
006600 

008 Y UO 
OOPHOO 
O0R°O0 

009143 

009100 01 
009200 

009 300 
009400 
004500 
009600 
009700 
0154,10 
Ci19 3|»0 


02 C l-LR - MASTIN- KfY, 

03 CUR’-MAST IN-ACT'T 
0* ClIM R-MASTIN-YYP*’ 

0? ‘ ‘ ' 


•ICTiPE IS 
PICTURF. IS 


02 fMAX °ri'fF|NES CURR-MASTI N-nEV PICTURE 
0? ClJPK- v *$T I N-Pf r f R BICT.Itf is *116 1 

p? CMBP-MasMN-ccnE pictuaf is x 


CuRR-MASTnuT. 

07 CUFB-masTl'UT-AFy. 


PICTURE is XI 2 1 


4 * 

OIGIUO 


0 10700 


01 0 *00 


oi 04 jo 


01 0400 




010 7550 


n i op no 

51 

OIOIOI 

5? 

oil 100 


011210 


2 C mk R •' C* t F 1 N E S CURl - ma 5 T()tjT -Kf v PICTURE IS itf 17 
17 CURR-MASTOUT-prtfV PICTiiVF IS X1I6I vll..r ll 

2 CURR - **AS T'UlT-C OOF PICTURE S 5 ‘ JJMf ,'1 

fv-^s?N?,r f|K ” curr-mastout-cooe pic/upf is fc x! S 


PRFV-MASTiUlT. 

0? PRi. V-MASTIUT-r t* , 

n> prfv-mastgut-acct 
03 P'FV-maST PU T - T V C» e 
D? PP| V-MASIflllT-Rcr FR 
o? ppf v-MasrnuT-c;'mE 

I** AN- Sdfl T -|rf y , 

02 TRAN-SfO-Xt Y. 

03 Y r AN- ACC T , 

0* TRAN -ACC T-AEY. 
05 UCCl-NCi 


PICIUFE 
P ICTURF 
P ICTlJBE 
PICTURF 


*121 VAtlir 
X I 1 6 I VALUE 
x V Al U r 


!? 

SPACES 

SPACES 

f l? 1 « 

IS 

S°ACES 

IS 

SPACE. 

IS 

SPACES 

S XI 101. 

IS 

SPACES 

1 12 

Surfs 

IS 

IS 

SPACE. 

X. 

\\ 

SPACES, 

SpagfI. 

IS 

SPACES. 

IS 

SPACE. 


05 TAN REDEFINFS TACCT-NC P IC^URE l ?S*XI 1 01 . 



INPUT 1 1ST I* 


AUTPHO* CHART St T - SAMPLE SIANOARD COBOL 


16 * 

1 65 
156 
I 67 
16ft 
|S'J 
1 SO 
lot 
16? 
lfc? 
16- 
16** 
166 
16 7 
1*« 
160 
1 TO 
1 M 
IT? 
17) 
IT*. 

1 ?6 
l Tfc 
1 77 
1 7 ft 
1 TO 
1 60 
1*1 
l ft? 
IB) 

1 ns 
1R6 
1 It 
1 ft 7 
lft? 

I 6° 
190 
l«l 
192 
1«3 
19* 

195 

196 

197 

1 9 ft 
j QQ 
200 
2C1 
202 
:oi 
20 * 
706 
?06 
207 
?0h 

209 

210 
211 
212 

21 3 

2 1s 
215 
? 1 6 
?! T 
>1* 
2l« 

22 0 
??1 
22? 
??' 

HS 

226 

HI 
2 2° 
2)0 
2)1 
?)? 
2)? 
23* 
236 
2)6 
?37 
?3P 

2)o 
2*0 
2* 1 
29? 
293 
2*s 
2*5 
2*6 
2*7 
2*9 
2*Q 
2 SO 
?M 
?S? 
253 
?S* 
256 
2S6 
2 ST 
26ft 

259 

260 
? 6 1 
2*2 
26) 
26* 
26S 
7 66 
2 67 
26* 
269 
? TO 
271 
27? 


? T* 

2 76 

?T» 
2 7 i 
2 7 9 
2 30 
?Sl 
?ft? 
2ft) 
?"* 
2 HS 
?96 
2 S ? 
7ftft 

2?9 

290 

291 
29? 
29? 
29* 

295 

296 

297 
2 9ft 
299 
)00 
301 
)0? 
) 0 ) 
)0* 
395 
106 
107 
)Oft 
309 


as 1A«VT-TVPC PICT'»°F IS *121. 

0- 14 i. or !i f 1M S f- A'l-AfCl-slY ** I C 7 u ** C IS *1121. 
O' tomstSCL P K TiP 1 IS *1161. 

0 J TACC1-.' P f P I C Tuft l IS X. 

O' 1 A ( 0£*>:HMS IA( C 7 — C I J1 - 1 P 1 C T U° E IS X. . 

0 ? TS» -lEIMNES TRAN-SFO-Xl 1 PICTURE IS XI 29 I. 
02_IoANS-CC0t. piCTlJM 


IS 


01 1 100 
01 1 1*0 
oi i*cr, 
ot isoc 
oi i*oo 
01 1 7oO 

on rod .. . 

011900 O' 7 C 1 

01 2U00 03 K2 

012200 02 TA“T 

012100 

Ol?*\>0 PftOCfOUPt DIVISION. 

0 1 < ‘.0(1 S1A°T. 

01 26 JO P°F N INPUT MASTfR-IN. 

0 1 ? T C0 f'Pf U INPUT T^ANS-IN. 

0 1 ?9*iO t-HASUP-RCUl INE THROUGH GET -M AST ER-EX I T . 

Ol'OOO P e AD-NS XT-T* ANS. 

S!j* 2 o "“.W& to 

013*00 7r V TPAN-S?FT-KEr A l's S NnT LESS THAN PREV-TRANSIN 

01*600 G " T DISPlSr K M&ANSACTinN-FlLE CUT -OP -$F Q* UPON CONSOLE, 

011700 STOP RUN. 

01 IP 30 T9 ANS-EGF • ... 

013*00 CLOSE TRANS-IN WITH IOC*. 

01*000 I F £«1F-S- IS NOT EQUAL TO SPACES 

01*100 GO TO END-CF-JCft, „ 

01*?00 ELSF MOVE * T • TO EOF-SW, 

01*V»0 MOVE HIGH-VALUE TO TR AN-SDRT-KF V » 


01--00 MQV: - K 

01*500 


01*600 Tf S T-TJT A - t A 
01*700 " 

01 * c 00 
oi *« no 

01 SO 00 
0161 00 
nis.’on 
01 MOO 
015*00 
016600 
015600 


’iRAN-SORT-KEY TO PREV-TRANSIN, 


O'jlAOfA-SW IS EOUAl TO SPACES 
GO TU COMPARF-JNPUTS. r „ _ w 

IF CURP-HASTUUT IS EQUAL TO TRAN-SFQ-KET 
GO TO TEST-TRANS-COOE. 

NOtf ••TRANSACTION IS HIGH TO OUTPUT MASTER RECORD. 

PERFUOM PUT - M AS T f ft THROUGH PUT-MASTER-EXIT UNML OUtACCT I 
S NOT LESS THAN TRACCT. 

oiTlS? Cn "°*? E T01‘“s!C-ltEV 1? IfSS TWIN CUTS-TASTIN GO JO TOANS-IOW. 
01 CIO f LSF PFTF0.1 p OT-;»STt» THSOUOH PI|T-««STE»-Fxn. 


01 1000 
0 1 6000 
016100 


■|F TSK IS EOI'AL TO CMK GO TO TEST-TRANS-COOE. 

„ GO TO TEST-OUTAREA. 

0l6?00 TOANS-LPH. 

olsioo Note *• IF ANS ACT I QW 15 in, 10 INPUT PASTER RECORD. 

016500 

016600 TRAANS-IPM. 

|r 7 ALTFR rN 7 -( f F-ACCT-EX?T Til PROCEEO TO TEST-TRANS-COOE. 

r.r n ENO-CF-ACCT-ROUTINF, 

USf IF TAC IS NCT EQUAL TO C*C 

r,n il ' tER^E VJ-OF -C POF-T x\ t P to pr nc f E 0 TO TEST-TRANS-COOE. 
Vf nu?APrA-si is not fouai to spaces* w r master-out, 

m:)V‘ SPACES Ttl OUTAB c A-S-, *» A ST OUT - N AMF - ADORE SS . 

|P TCI IS ( f)U*L n l MOVE 'ERMfiR DFL E T F p i COROJ TO 
f ROOM-TYPE ANO ALTER I NO-CF -CODE -E X I T TO 
C. 


01 67PO 
016 ftOO 
016900 
01 7000 
017100 
01 7200 
01 7)00 
01 7«.00 
017600 
01 7 *>00 
017700 
01 7*00- 


TO oROCtEO TO ERROR- PRO 


TO SPACES 


NOTF ••TRANSACTION CODE IN ERROR. 


0 I 7900 r NO - C1F -COOE-E X I T. 

01 *000 GO TO. 

OlftlOO 

01 R?D0 Tesr-TRANS-ennf . _ 

OlftlOO l c OUTAPCA-SM IS EOUAl - - - 

016*00 MQv r M4^T£°-1N Tp MASfER-OUT 

0) a SOC MOVE C’JR s -MAST!N-<EY TO CURR-MA STOUT -KfY 

01P600 PPYFjRm C.E T-MASTt J-RPUT INF THROUGH Gt T-MASTER-EXl T . 

01 **7(10 GO 7 p Of I F TF-TPANS. ADD-TRANS* CHANGE-NAME, CHANGE - AOOR ESS Ok 

OlftftQO- PENDING ON TCI. 

01 P900 
019000 
019100 

019100 ”**8' 3 5? , ?«8nc!!SS , e»t ?RROR* ID ERROR-TTPE. 

MHVE HIGH-VALUE TO TRANS-COOE. 

019*00 r RPpc - PRQC « 

S51783 HlfMISSW'ow-. tp»ns-sor.-«ey. 

019700 TNTFR COBOL. 

019-00. GO TO Rt AO-NE XT -TRANS • 

- 1 "--° CM * N fE'nO't4“hs, is COURI TO SPSCES cn to chrmcf-error. 

IF TC? railALS 2 GO TP CHANGE-ZIP. „ rr 

! c Tf? IS LESS THAN * GO TO CHANGE-? A, 

IF NOT EQUAL TO £ GO TO T R ANS ACT I ON-COOE -E R»OR. 

IF FQUAI TU * GO TO CHANGE-CITY. 

MOVE TP S T AT E TO OUT ST ATE. 


ERRpP-T YPE . 


020000 
020100 
020300 
020* DO 
020500 
020*00 


020700 CHANGE -f ITY 


021000 CHANGE-ZA 


MDVE T9CITY TO OUTCITY. 
GiJ TJ CHANGE-? A. 


021100 
. 021)00 
021*00 


021500 CHANGE-ZIP. 


1VF TRZIP TO OUT? |P. 

**n vF TRA0DRE5S TO OUTADDRESS. 
GO TO REAC-NEXT-TRANS. 


v .ip-ip MDV C TR7IP TO OUT? IP. 

021700 GO TO RE ID-NEXf-TRANS. 

021300 PUT-MASTER. 

021900 


02 2000 
C?? 10 U 
022200 
022)00 

022*00 


9 I TF 'MASTER-CUT , Mi"*VE SPACES TO OUTARFA-SW. 

IF T ft K IS LESS THAN C M AK 
G'l TO PUT - MA ST E ° - c X I T , 

fLSr MOVf MASTER— iN TO MASTER -OUT . MOVE CURR-MAST IN 
TO CURR-masTUUT, MOVE •F* TO UUTARFA-SW. 

M JVF Hlf.H-VALUC 70 CURR-MAST 1UT -XfY, 

|f [PF-Sw IS NUT EQUAL TO *M' GO TO GE T -MASTCR-ROUT INE • 


02 2 c 00 PUT -MASTER-EXIT . 

0227.00 EXIT. _ 

023200 GET-masTF R-RUUTINE. _ 

023*00 NOTE. NCM MASTER REAP ROUTINE. 

0 2 3*00 GET-ma SIC 5 *-® OUT INI-1. 

0?1'»0C 9 FAT MASTER- IN, 

023*00 AT I NO GO TO MASTfP-EOF, 

02.3700 Mil Vf MAS! IN-HI Y TO C'fPR-MASTIN 


0? 3ft DO 
0? )°00- 
02*000 


Miivf h I r,i*-v AL UF TO CU R| *- M *ST 1 N-CODC . . . 

|«- f I| 1 '- -**AST| N IS LESS THAN PRkV-MASTIN DISPLAY »MAS 1 E® FILC 


MOVE SPACES TO OUTAREA-SW 

cu»i;-MAS r nuT. „ , 

I F TCI IS NOT FQIJAL T P 2 MOVE 


MA STOUT-N AM6- ADD®€SS* 


•NON MATCHING TRANSACTION* 


i jgt OF SCO' UPON CON SOI F , STOP RUN 

„ M^VF CUFR-MRSIIN TO PRFV-MASTIN. 

02*100 GET-maSTFR-EXIT, 

02*200 FX I T. 

02*300 GET-MASTEP-f x|. 

02**00 GO TO PUT-MASTER-EXIT. 

02^600 M4ST M0vF'M' TO EOF-Sm. MOVE HIGH-VALUE TO CURR-HASTIN. 
02*700 MOVE 2 TO INTC1 . GU TO GET -M AS T ER-EX IT . 

02*900 fN A LIE R^E NO-OF - ACCT -EXIT TO PROCEED TO CN0-T0-E‘)J2-EX|T. 
025000 ^C-rP-ACCT-ROUTINE. pouAL TJ 

025? 00 MOVE SPACES TO OUTAREA-SW, MASTOljT-KEY 

025)00 
025*00 
G? 6500 
0? 6600 

02 5 700 FNfl-OF-ACCT-E * 1 T 
026900 GO TO. „ 

026900 FND-TO-F 0J2-EXI T. 

026000 EXIT. 

0261 00 

026200 ADD-TRANS. _ 

8|?288 “? vf ,E.J“frr,uI? OUICnOF ISEQU.I tnj. HOVE 

027500 OUTCOOF , MRITt MASTfR-OJl. “UVE 2 TO CUTCODk. 

026600 C ; 1 TU RE AU -NeXT -TRANS. 

U267JJ 

026900 PUT ft9 C A - SW IS EQUAL TO SPACE GO TO CHANGE-ERROR. 

027000 MOVC TRNAMf TO OUlNAMF. 

MOVE Hl&M-VALUft TO PP CV-NASTOUT-xEY. 

027100 GO TO REAO-NEXT-1 RANS. 


1 0 fpSnR-TYPE ANO ALTER END-OF-ACCT-Ex]T TO PROCEED TO 
f. <>3n<»-p*nc. ELSE MOVE SPACES TO ERRUR-TVPE, 



3-48 

^V/iVTo i»octrijo*t sutf"*.T 

PG.6X 

NAME 

5.11 

ADP-TR ANS 

).?0 

C*ANGr-A0C*?SS 

1.2* 

CHANG 1 -Cl TV 

6.0A 

CHANGE -FR«0» 

5.Z0 

CHANGE -NAHf 

).?« 

CH ANGF-IA 

).?7 

CHANGE -2 IP 

2.7) 

COMPARE* INPUTS 

5.2? 

oelftc-trans 

*.10 

CNO-OF-ACCT-EXIT 

5.0' 

f NP-OF- ACC T -ROUT INC 

3.09 

CNP-Of -COOE-EXl 1 


t*0 cl index AuTnnnj chart $m 

NAME 

3.0) ENO-Of -COOC-*nUTlNE 

2.20 ENO-nf-jna 
5.02 ENP-T0-E0J2 
5.1? f NC-TU-E0J2-EXI T 

1 .21 tOJi 
2.28 FO J 2 

J.17 «RROR-PROC 
A. 17 GET-NASTER-CXfT 
5.01 GET-NASTER-EXi 
A. 08 GE T-NASTIR-ROUT INE 
A. 00 GFT-MASTER-R0U7INE-1 
A. 15 MASTEP-EOF 


SAMPlf. 

stA'HURO coant 

pg. ax. 


2.1A 

MOVE -HEX 

5.2) 

NOTE 

A. 01 

PUT-NASTtA 

A. 07 

PUT-MAS7 1 5*EX 11 

? . 03 

fi E AP-Nt X "* T« ANS 

2.01 

STAR! 

2. 15 

TEST *OUT AREA 

3. 11 

7EST-T9ANS-C00I 

2.31 

TRAANS-LON 

2.11 

trans-eof 

2. 30 

trans-low 

1.16 

TRANSACT 10N-C00E -ERROR 


RAGE l 



c * R o in PAor/fv 


»*oir ME CONTENTS AND *rFEBENCFS 


AUTHFIOW CM AO T SET - SAMPLE 
■CFfBfNCES ISnuRCE SEQUENCE NO. ANO PAGE/BOXI 


COBCl BOOIIIE 

CH»»t TITLF - 

CH4BT Tltlf - 

012500 

2. 

013000 

2. 

013800 

2. 

01**00 

2. 

01**00 

2. 

015*00 

2. 

027700 

2. 

0 1 5700 

2.' 

015700 

2., 

02*100 

2. i 

029100 

2.; 

02*300 

2. i 

016200 

2. 1 

016600 

2. 3 

016*00 

2.3 

01 7000 

l.C 

017700 

l.C 

01 7J00 

3.0 

01 7600 

3.0 

017700 

3.0 

017900 

3.0 

01 7900 

3. O' 

OIBOOO 

3. ll 

01 B200 

3.1! 

01*700 

3. 1< 

019200 

3. 11 

019*00 

3.13 

019900 

3. ?C 

020700 

3.26 

021500 

3.27 

021000 

3.20 

021*00 

4.01 

022500 

*.07 

023200 

*.08 

023*00 

*. 0*3 

02*500 

4.15 

02*000 

4. 16 

02*100 

4.17 

02*300 

5.01 

02**00 

5.02 

02*900 

5.02 

025000 

5.03 

025*00 

5.06 

075500 

5.08 

025600 

5.09 

025700 

5. 10 

025700 

5.10 

025000 

5.11 

025900 

5.12 

026200 

5.13 

026600 

5.19 

026000 

5.20 

027210 

5.2? 

027231 

5.23 

027233 

6.01 

027300 

6.0* 


PAGE 1 

3-49 


ITlf - PfiOCFOUPE DIVISION 


01 S T AST 

05 *EAD-NEXT- TRANS 

11 7RANS-F Of 

14 MOVE-KEr 

15 Tf ST-HUT AR E A 
IB 

20 ENO-OF-JOB 
2T COMPARE- INPUTS 
? J 

?T EOJl 

n 

?B EOJ2 
10 TRANS-LOW 
>1 TRAANS-LOW 

12 016000 

• 1 

'2 01 7200 

1 ENO-CE-COOE-SOUTINE 

6 

B 017700 

9 E ND-OE-CQOE-f XI T 
9 

0 01B0000 

1 TEST- TRAN S-C DOE 

I 

> TRANSACT lON-CnOE-ERROR 
f FRonR-PRrjc 
I CHANGE-ADDRESS 
* CHANGE-C I TV 
CHANGE-7 IP 
CHANGE-/ A 
put-nastfr 
PUT-NASTER-EX IT 

GE T -MAS T ER -BOUT |NE 
CET-NASTER-ROUT INE-1 
haster-eof 

CET-MASTER-f X IT 
GET-MASTER-EX1 
EN0-T0-E0J2 
024900 

end-of-acct-routine 

02 SS 00 

ENO-OF-ACC T-ex IT 
0250000 

END- TO-FOJJ-E X I T 
ADD-TRANS 

CHANGE-NAME 

OEIETE-TRANS 

NOTE 

0272X3 

CHANGE-ERROR - 


02710* 
01 3200 
01 3 A 00 
016100 
015500 
01*000 
01 *700 
01 5*00 
020000 
027800 


02570D 

016700 

017900 

017*00 

OIBOOO 

017200 

017600 

OIBOOO 


S W 


2.06 
2.06 
2.26 
2.19 
2.12 
2.15 
2. 18 
2 . 2 ? 
2.21 


5. 10 
2.31 
3.09 

3.03 

3.09 
3.02 
3.06 

3.10 


81 238 


027233 


011700 3.08 


01 *<>00 
025700 

2.1 6 
5.10 

016000. 

2.2 5 

017000 

3.01 

017900 

3.09 

01 8300 

3.11 







020*00 

3.23 







010000 

3.09 

025800 

5.10 

027500 

6.0* 



018700 

3.14 






020500 

1.2* 







020100 

3.21 







020300 

3.22 

020900 

3.26 





015*00 

2.1 9 

027900 

2.2? 

Cl 5900 

2.24 



81.288 

2.19 

5.01 

02 7 900 

2.22 

015900 

2.2* 

022000 

4.03 

012900 

2.0* 

01 8600 

3.13 

072*00 

*.06 

022600 

4.07 

023600 

4.10 







023800 

*.12 







01 2900 

2.04 

01*600 

3.13 

02*700 

4.15 



02*200 

4.17 






020200 

2.27 







025700 

5.10 







016900 

2.32 







025100 

5.03 







025800 

5.10 







02 5*00 

5.06 







016800 

2.12 

02*900 

5.02 

025500 

5.08 



025600 

5.08 






02 5800 

5.11 







079200 

2.27 

025700 

5.10 





01B700 

3.1* 

026000 

5.12 





026*00 

5.1* 

026*00 

5.1? 






019700 

018700 


0? 7800 
020000 


3.14 

3.1* 


2.20 

3.20 


02 6 9 00 5.20 



oa/jvto 


aijtDFLPH CHART SET 


STANDARD CO^Ot 


-4Cg pi 


CHART TITLE “ REMARKS 


REMARKS. AN AUTOFiny CHART PROOUCFD FPOM COBOL SOURCE INPUT 
"AY CONTAIN UP TO FIVE PARTS. THE LISTING OF THE SOURCE 
INPUT. THE TABLE OF CONTENTS AND C»OSS REFERENCE LISTING. 
THE TABLE OF DIAGNOSTICS, A 'REMARKS' PORTION AND THE »LOW 
CHART PRODUCED FRO* THE PROCEDURE OtVtSION OF THE SOURCE 
PRO GRAN. 

The LISTING of the SOURCE INPUT IS OPTIONAL. SELECTEO BY 
THE USER IN HIS PARAMETER CARO. THE INPUT LIST OPTION 
HAS NOT BEEN INVOKED FCR the AUTOFLOW CHABTING OF THIS 
PROGRAM. 

THF TABLE OF CONTENTS INDICATES THE CHART LOCATION OF 
EACH SECTION OR PARAGRAPH WITHIN THE PROGRAM AS WELL AS 
ALL REFERENCES TO THE SECTION OR PARAGRAPH PRODUCED FROO 
THE GO TO. PERFORM. ALTER, AND PROCESS VERBS. IT ALSO 
INDICATES THE SOURCE CARO NUMBER CIN Tng NAME FIELOI OF 
ALTER STATEMENTS ALONG WITH THE CHART LOCATION OF THE 
STATEMENT BEING ALTERED. CRCSS REFERENCES PROC'JCED BY 
LOCAL DECISIONS, THOSE DECISIONS WHOSE PATHS COME 
TOGETHER at 'NEXT SENTENCE'. ARF INDICATED WITH A BLANK 
NAME FIELD, 

WHEN PRESENT, THE 'REMARKS' STATEMENT IN THE 
IDENTIFICATION OIVTSION WILL APPEAR AS INTROOUCTORV 
NARRATIVE. IN THE TEXT FORMAT OF AN AUT 0 F LG« FLOW CHART, 

IF HO 'REMARKS' STATEMENT IS PRESENT. THIS NARRATIVE 
CHART IS NOT PRESENT. THE MATERIAL CURRENTLY BEING 
PRINTED IS AN EXAMPLE OF THE 'REMARKS' STATEMENT NARRATIVE 
CHART ■ 

EACH PROCEOURE 01 VI SION 'SECTION' PRODUCES A CHART, WHOSE 
CHART TITLE IS THE SECTION NAME. THIS CHART TITLE APPEARS 
IN THE HEADING OF EACH FLOW CHART PAGE PROOUCEO FOR THIS 
SECTION'S PROCEDURES. AS EACH SECTION BECOMES A CHART, 

THE FLOW CHARTS FOR ANY SECTION NAY BE LOCATED FROM THE 
TABLE OF CONTENTS. 

WHEN A PROGRAM IMPLIES A BRANCH FROM ONE SECTION TO THE 
NEXT, A BRANCH SYMBOL IS GENERATED IN THE FLOW CHART. 


THIS PROGRAM IS INTENDED ONLY AS A SAMPLE DF A PROGRAM 
WHICH MIGHT BE RUN UNDE* AUTOFlCV. IT PROBABLY 1$ NOT 
SUBJECT TO CLOSE SCRUTINY FOR LOGICAL PROGRAM CAPABILITIES. 



04 / 2 ?/ro 

CH*B? tITLE - PROCEOUPf 0 1 ¥ IS ION 


13 - 


AUTOFLOtf CHARI $ If - SAMPLE IT ANDAR0 COBOL 


9 0 I 25 OO / 


START paragraph 

O12AJ0 I 01 

/ / 

/ / n ' Km .- ir u V 

' / 


012700 | 

/’ *’* 

/ * 

/OFF* INPUT / 
9 TRANS-lN / 

9 / 


02 

”7 

/ . 


012500 


01 


#' /' 
/ / 


FCQFUAN 
GFT-MA$TER- 
POUMNE 
through 
-T-«* r 
Ell 




oi.i **— >1 

AfAn-NEXT-tPANS 

PARAGRAPH 


011100 

/’ 


_05 

7 


/MAO / 

/ TRANS-IN / 

/ / 


01 1200 • 06 

• • 


• • YES 

• AND hr ruf • 


• 6 

1*0 


l-Vljr to j 

1 _TRAN-JoRT-*FY J 


011400 * OB 

• • 

• TRAN- • 

• SORT-* E V IS* YES 

• NOT LESS THAN • 

• FREY- • 
•TRANSIN* 

• • 



NO 

01*600 

s: 

« 

i 

i 

i 

S 


/DISPLAY / 

/ (TRANSACTION- / 

/ F JlF OUT-OF- / 

/ Sf O' UPON / 

/ console / 


011700 _ I 10 ^ 
*~HALf • 

TNC OF RUN 


->* 

TRANS -I OF PARAGRAPH 

011ROO__I 11 

/ ”* ~~ * 7 

/CLOSE / 

/ TRANS- IN WITH / 


•Stf 

r 

5 l 12 


• EOF-SW IS • YES . 
• NOT EQUAL TO 

• SPACES • 


014200 

NO 

12 

TO EOF-SH 

M"VF 

HIGH-VALUE TO 
tran-sort-key 


14 

MOVE-KEY P 
014500 


I HOVE 

TRAN-SOFT-KfV TO 
PRfV-TRANSIN 

02.26 >J 

test-outarIa 

PARAGRAPH 

l 1* 


PA GRAPH 

014 T 0 O 


•OOTAREA-SW • 
IS EOUAL TO 
* SPACES 


01 4400 


16 


• CU4R- • 

•MASTOUT IS • YES 
• EQUAL TO 

• TPAK-SEQ- • I 

• FEY • I 


NO 

TCST-TRANi 


1 

11 


TRANSACTION is 
HIGH TO OUTPUT 
•ASTER RE CORO. 


. mil is»; 

• tracct • 


4 

PF RRQRM 

4 


PUT-MASTER 


0 

through 

0 

l 

PUT-HASTE*- 

7 


EXIT 



—02.12*— >• 
EN0-0F-J08 PARAGRAPH 


A 

027700 1 

20 

ALTERED GO TO 

1 

ST4TEMENT 


ALTERFD to 

„ 

BY PROCEED 

TO 1 

027211 


6.01 

-_1 


I „ 


•OUTAREA-SM • NO | 

• IS NQI EQUAL • . 

• TO SPACES • A 


YFS 


02 7 900 


4 

PERFOPH 

4 


put-haste* 


6 

THROUGH 

0 

i 

put-master- 

7 


EXIT 



EOJI 


02.15*— >• 


COMPARE-INPUTS 

PARAGRAPH 


• TRAN- • 

•SEO-RET 1$ • YFS 

LESS THAN • » 

•CURA-NASTIN* 


4 

PERFORM 

4 


put-nastei 


0 

through 

0 

1 

PUT-MASItt- 

7 

»• — 

EXIT 



• ISA IS FOUAL 
• TO CNR • 


,N0 :T: 

TEST-T*AN$ 
26 
2 . Ill • 


• •• 

TEST-OUTAREA 


— 02 . 21 *— >• 

EOJI PARAGRAPH 

0212 00 | 


PERFORM 

"wasp* 

FNO-TO- 

E0J2-EXIT 


C0J2 PARAGRAPH 
02*400 


/CLOSE / 

/master-out mith/ 

/ LOCK / 


02*500 l_29_ 

• halt" • 
EMO OF RUN 


— >• 

TRANS-LON PARAGRAPH 


016400 I NOTE 10 
• •• ••••••** 

• TRANSACTION is 

• LON 10 INPUT 

• MASTER RECORD. 


TAAANl-LOW PARAGRAPH 


l.» 


016700 

•TAN IS NOT • NO 
• FOUAL TO CHA 


05,10— -> 
016*00 


alter 

ENO-OE-ACCT- 
fAIT TO 
PROOFED TO 

tist-twans- 

COUt 


• 1 . 01 . 

• • 

• •• 

ENO-OF-ACCf -ROUTINE 





^-52 


©A/27/70 

Cmast tivic - procedure division 


AUTOHOW Cn A* T SFf - SAMPLE STANDARD COBOL 


MCE 01 


/ 01 TOCO / 

2.11 >| 

* 01 


. *TAC IS SOT • »rs 
• EQUAL TO C*C *- 


. 02.16*— >• 


HST-T66HS-C0DI 

PAR AGP APH 


01 . 0 * 

017200 


ALTER 


f NO-OP -CHOE - 


EXIT TO 


_PROCEE0 TO 


TM1-TRANS- 


Cnof 



n-OF-eno -* 


EW*. 
PARAGRAPH • 


NO *outarfa-sn • 

- — • IS NOT EQUAL 
• TO SPACFS • 



TES 

01 7A00 

OA 


/ / 

/mur / 

/ master-out / 

> / 


•- 

L 


OITSOO 

mot* 


aswsius 

PA$TOjf-NANf • 
A"DRF1S 


i >j 

01 7600 • 06 


NO * . 

* TCI 


HI 


FOUU 



TES 


^ 017600 


07 

«UV« 

•c*;p« ofletf 
AEC nRO* TO 
*RRQR-TV»f 

01.09— > 
017700 


0* 


H 

H A( TER 

H fO-OF-mo*- 
“ EH T TQ 


Purr ctr, f 
f kPO*-PR 


» 


— 01.02*— >1 

l»5»?U£2' , ' c *' 


017*00 

1 . 


ALTER 

IP GO TO | 


STA 

TE*rNT 

AL 

TFRCO 

TO 


0T 

PPOCgco Til | 

01 

7200 

Usr-T*AN I 

01 

7700 

Mvjiiiii I 



R.O* 

7.17 1 


o?o6ooo’"*l to 


omoo • it 

• • 

NO *nyTAPFA-Sk * 

p— -'VHa ,0 . 


01 BA 00 
h nv« 

nastep-in rn 
MASTFR-OUT 
move 

CURR-MASTlN-RCy 

TO 

CURR-MASTOUT-XET 


A 

PEPFOR" 

. 

CET-mSTES- 

0 

SOUTINE 

B 

THPOJf.H 


GET-HASTER- 
ex it 


010700 f U 

'£ s KJ 5 « a "i 
ji?r* 

m 


0*1 FTf -TR A 
AOn-T* ANS 
CHANCF-VA" 

Change -A 70 


• Pfj», ! wi . 

: ITK J s*i # ST. 

i< — 

J*fNSAC T| ON-cnnF- 
FRROR PARAGRAPH 


I 


^oijioo 
"coh*€«'o«J°TI> 

HjGH-VALU* TO 
TPANS-C03E 


::‘l 


01.09*- 
F*«OR-PAC)C ’PARAGRAPH 


019900 I NO 

**•••••• 

• FNTFR 

• i I nk age. 


019600 I IB 

.... 

s 


• • • 

2.01* 


MAD-MU-PANI 


I 019900 

02.14 >• 

CMANr.f-Af>OP€ ss 
PARACAAPH 


020000 


20 


• .XwiiX •? 


020100 


I NO 
change 


... . 

ot: 


21 


• TC2 EQUALS 7 • 


• TFS 


->• 


• • VIS 
• TC2 IS LESS 

• THAN A • 


TFS 


-• NOT EOUAL TO 

• • 


TES • 

• EQUAL TO 4 


1 NOVF 

— 

TRSTATF to 1 

| outstate 1 


| 

CHANGE-CIT 

r PARAGRAPH 

020900 

26 

1 HOVE 


1 T»C ITT TO CUTCtfT \ 


CHANGE *2 IP PARAGRAPH 
t 021ft 00 J 2T 

Lr??i!LI5L!S! , i^ 1 


• 2.05. 

1 ... * 

RE A {Ml* XT -TRANS 


— 01.22*— >• 

CHANGE-2A PARAGRAPH 

* 021100 | 20 

* 

pJJJjj 1 * T0 
tpaoo**ss to 
JIuTAOWlSS 

... 

; 2.t»: 

• . 

... 

RE AO-NEXT -TRANS 


CHANGE -2 A 


• 1 . 10 . 
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04 / 77/70 opoetnupF division summary 


AUTOFLOW CHART SET - SAMPLE STANDARD COBOL 


altered PAR AG* APhS 


PAO Ar.HAPH 
Al Tfc*£n AT 

00 7*700 

001 5»*oo 

0024QOO 

0025500 

***** 

oo 

>VMQ 

F NO-OP -ACCT-EXIT 
IN TRAANS-LUW 
IN FNO-T0-E0J? 

IN ENO-OF-ACCT-RCHITINE 

PARAGRAPH 
ALTFPCO AT 

ooo 

ooo 

oco 

ooo 

3.09 

3.02 

3.06 

ENn-pP-COOE-EXl T 
IN traans-low 
IN END- Of -CODE -ROUTINE 

PARAGRAPH 

Aiuicn AT 

0O2TT00 
002 7 23 3 

2.70 

6.01 

f NO-OP— JOR 
IN NOTE 

PPRFCAMfO PROCEDURES 



FNO-TO-E 0J2 




PERFORMED at 

0029200 

2.27 

IN ED)| 

G»T-Mste»-«ouniie 



P?RFOR“f D AT 

0012900 

2.04 

IN START 


0018600 

3.13 

IN Tf ST-TR ANS-COOE 





RERFOPMEO AT 

0015400 

2.19 

IN tfst-outarea 


001S400 

2.24 

IN compare-inputs 


002 7900 

2.22 

IN fND-OF-JOR 

I/O PILE ACTIVITY 



MASf'R-IN 

0012600 

0023500 

2.01 

4.09 

IN START 

IN GET-MASTER-ROUT INf-l 

HAITI A-OUT 

oooooo 

OOOOOO 

® » vj*~ ..Is* 
*«*•-«*» 
ocoooo 

OOOOOO 

2.0* 

3.04 

4.01 
5.U4 

5.1 7 
2.28 

IN START 

IN FND-n^-CPOE-RCUTlNE 
IN PUT-WASTER 
JN ENO-OF-ACCT-ROUT INE 
IN ADD— TRANS 
IN EQJ2 

TRANS- IN 

oo moo 

0013100 

0013900 

2.07 

2.05 

2.11 

IN START 

In-RFAO-NFXT-TRANS 
in trans-cof 


STOP SUMMARY 


mmu 

INITIALLY 
TO PROCEED 


INITIALLY 
TO PROCEED TO 


TO 

0014200 

3.11 


0025900 

5.12 


0019400 

3.17 

TO 

0018200 

3.11 


0019400 

3.17 


WiTJHHPew 

END-TU-ll)J2-f*lT 

ESROS-PSOC 

UN5PFC I F I *0 
TEST-TRANS-COOE 
ERROR- PPOC 

UNSPECIFIED 

ERROR-? 


PERFORM 

« 

ENTRY 

THRU 

0024900 

0025900 

?:?i 

FND-T0-E0J2-EXIT 

PERFORM 

ENTRY 

THRU 

0023200 

0024100 

1:B 

CET-NASTER-EXIT 


ENTRY 

THRU 

0023200 

0024100 

4. OS 
4.17 

cet-haster-cxit 

PERFORM 

ENTRY 

Thru 

0021800 

0022500 

4.01 

4.0? 

put-hastir-e*it 


entry 

thru 

0021800 

0022500 

4.01 

4.07 

PUT-NASTIR-f X1T 


entry 

THRU 

0021600 

0022500 

4.01 

4.07 

PUT-HASTER-EXIT 


OPEN INPUT NASTER-IN 
READ MASTCR-IN 


OPEN OUTPUT MASTER-OUT 

WRITE MASTER-OUT 

W*tT* MASTER-OUT 

WRITE MASTER-OUT 

WRITE MASTER. OUT 

CLOSE MASTEK-OUT WITH LOCK 


OPEN INPUT TRANS- IN 

REAO TRANS-IN 

CLOSE TRANS- IN WITH LOCK 


IMS 5:1“ 13 

2*500 2 .29 IN 


*F AO-N* XT -TRANS 

CET-MASTfR-ROUTINE-l 

E0J2 


STOP RIM 
STOP RUN 
STOP RUN 


nisnAY SUMMARY 


0013600 

00231100 


1.0 

4.13 


IN READ-NEXT-TPANS 
IN CET-MASTIR-RUUTlNE-1 


sirs :affi«ierHHo«;j?-swi & c r nM 


CALLEO PROCEDURES 
ERROR 

CALLED FAOM 0019600 


3.18 IN ERROR-PRQC 


FA6( I 





AUTH'in* Cm AH 1 Sft - SA*PlF STANDARD COAPl 


PAGE 1 


CP’D IP 
TO 9400 

oo**oo 

004400 

C09f>00 

00*400 

000400 

OOQOOO 

oonson 

00*900 

009*00 

009100 

009100 

009»00 

oo Q ?oo 

009700 

ooosno 

00 A 1 00 
00P300 

003100 
003700 
003*00 
003400 
003600 
003300 
C03900 
003700 
004 000 
007400 
004100 

002900 
003000 
003500 
004600 
004 700 
004200 
004*00 
005500 
009200 

004600 
004100 
004300 
005000 
G05700 
004 900 
005 POO 
007*00 
007900 
OICOOO 
010200 
010500 
010100 
010400 
010300 
00*000 
011600 
01 1 500 
011100 
011300 
011350 
012200 
011200 
011900 
012000 
006600 
007200 
OlOboO 
010900 
Cl 0700 
01 O' 00 
01 l POO 
005900 
007000 
C06400 
006400 


DATA CMfi55 ©rtraFMf F 


HATA NAME 


RlFfPlNCFS (SFQUtNCE NO. AND PAGf/A.Ifcl 


CMA 

CMAK 

CMC 

curp-maat 


016700 
022000 
01 7000 
016000 

01 5*00 
0*4600 


?. 31 
4.03 


3.01 

2.24 


Q7>?00 4 S Q4 
024000 6.16 


023700 6.1 |-« 


Cl)°«-“A5T IN- ACC 7 
CU» 4 -**A5!1 4-C00t 
Cu«o-HASl IN-Af V 
CUOK-MASl 1N-PEPER 
CU94-HA5TI4-IVP7 
C.UBK- M AS!OllT 

CU4«J-MA^TnuT-ACC1 
Ctioo- MAS TOUT-CODE 

CUOB-MASTOOT-«EY 

CU99-MAST0UT-«fPE« 

CU9P-MAST0UT-TVPE 

•EOF-SN 

|«AP*-TVP€ 


(000274 1 
010500 

4. 11-" 
3.12 





014900 

027220 

2.16 

5.22-“ 

022 300 

4.04-N 

025300 

3.03-H 

01*500 

3.12-N 

( 000264) 

4.04-N 



014000 

Mitt 

2.12 

3.07-P 

5.09-M 

014200 

019300 
02 7400 

2. 1 3-N 
3.1 6-N 

6.04-N 

022400 

019600 

4.06 

3.10-U 


TNACCT 

1NA00SFSS 

INCITY 

INCODE 

INNATE 

INPEF 

instate 

IN T V® E 
1N2IP 


MASTE9-IN 

012600 

2.01 

01*400 

3.12 

022200 

4.04 * 

PASTF*-{HIT 

012800 

021900 

2.03 

4.01 

02 8400 
022200 

2.29 

4.04-N 

0.7400 

025100 

1:85 

HAST IN 

nastin-kfv 

HASTIN-NAHf-AOOPESS 

023700 

4.11 





hastdut 

026300 

5.13-N 





HASTHUT-KSY 

025200 

5.05-H 





MAS TOUT-NINE -ADDA fcSS 

01 7500 

3.05-M 

024200 

S.05-N 



TUTACC T 

015400 

2.23 





OUT ADC® F SS 

021300 

3.20-M 





OUTAAFA-SH 

SU>3o 

025100 

m 

077800 

070000 

025200 

felL 

8!I$o°8 

026900 

Ml-. 

5.20 

OUTCITV 

020800 

3.76-H 





OUT CODE 

076400 

5.15 

026500 

5.16-N 

026500 

J.1M 

1UTNAHE 

077000 

5. 21-* 





r*uTAfF 

0UTST6TF 

OUTVPE 

020600 

3.25-H 





0UT2IP 

021600 

3.77-H 

021100 

1.28-N 



paev-hastin 

023800 

4.12 

024000 

4.16-N 




PSEV-MASTOUT 

prev-mastdiit 

V-MASTOUT-ACCT 
PRF V-NASTUUT-CPOt 

PAEV-MASTO'IT-KEV 1 0003091 3.21-H 

P9E V-MA STOUT- SF FES 


PAEV-p A STOUT- TYPE 

PSFV-TSANSIN 

TAC 

TACCT-COOE 

TACCT-NO 

TACCT-TYPF 

ta* 

T ANT 
TAN 

TCI 

TC2 

TAACCT 

TAADOAFSS 

TAAN-ACfT 

iaan-acct-kfy 

TSAN-SEQ-4CY 

TAAN-S09T-KEY 

TSANS-COOfc 

taans-in 

TAANS’NAME-AOOKESS 

TRANStN 

TRANS IN-KEY 


013400 

2.08 

014500 

2.14-N 

017000 

3.01 




022000 

4.03 





016700 

7.31 





01 7600 

3.06 

01*600 

3.14 

023400 

3.06 

020100 

3.21 

020300 

3.22 

076400 

3.14 

015500 

2.23 





021)00 

3.70 






014900 

013300 

2.16 

2.07-H 

015000 

013400 

2.7) 

2.0* 

014300 

2.13-" 

(0002351 

012700 

3.16-N 

2.02 

01)100 

2.05-H 

01)900 

2.1t 


026300 4.13 


024600 4.15-N 

025500 5.07-N 


023500 4.09-N 

a:ssi (:ir 


*!is m 


014500 2.14 
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0 *O ?/?0 

f ItF SECTION 
10 LVl 


Dili *FCfWO NAP 


002*00 

oo?«>oo 

O^^OJO 

ocjioo 

0 0 1 7 r* o 
Of" »oo 
0&'«.no 
00 **.00 

00 1 f - 00 
001700 
00 "* ■ 30 

0 C '®00 

oc*oogz 


DATA NAMf 

fo paster- in 


02 

01 

O' 

01 

O' 

0 » 

01 

O' 

01 

01 

03 


'AST 1*1 
MAST IN-AFT 
I N ACC T 
IM»Pt 
IN 1 EF 
INff'OF 

1 NAD 0 «ISS 

IN||R 


00*100 FD na$TE A-CUT 


00*60 0 
00* 7*10 
CO* »oo 
00*«00 
ociooo 
oo^i a o 
OOVoo 
OC 1530 
005130 
0C5600 
005700 
OC53QO 


006*00 
006500 
006600 
006700 
CC6P00 
0C6O00 
007000 
007 100 
007200 
007300 
007*00 
007S00 


01 •'ASTOUT 
6? “AST CuT-Rf? 
01 outacc? 

01 OuTVOf 
03 OUT 1 C F 
03 nuTfrof 

°o i "gSJSH 

m cutaddhejs 

03 our U TT 


03 OuTATaTI 
os out z i a 


005900 FD TRANS-IN 


01 TRAN SIN 
0? T'ANSIN-KEV 
01 T«ACCT 
03 TR T YPr 
03 TRFF 
03 TOCODf 

°$i T ?i«;? iN| -* 00WM 

01 TRAOORESS 
03 TRCITT 
0} TRStATI 
03 TR||P 


auto flow chart set - sanpie standard cobol , ACC 

OFFSET IINCTN • QIC OCCURS CUSS USACF fl« VALUE 

^characters 0 ,s S74>,dod ' *«■ contains ?ooo characters, accord contains too 


10-11 

12-27 

26-21 

29-5* 

55-77 

7A-0? 

93-9* 

95-99 


2 

16 

I 


l c*siu?f 2 ; n ,s st “ ,dmo - 


A/N 

A/N 

A/N 

A/N 

A/N 

A/N 

A/N 

A/N 


BLOC* CONTAINS 2000 CHARACTERS. 


wi 

DISPLAY 
0 1 SPL AT 
OJSPl AT 

DISPLAY 
0 1 SPL AT 
r I SPL AT 
OISPl AT 
Of SPLAT 

RECORD CONTAINS IDO 


0-9 

!§:H 

21-21 

29-3* 

53-7? 

TP-92 

93-9* 

05-99 


3 

it 

15 

? 


A/N 

A/N 

A/N 01 SPLAT 
R/N DISPLAY 


A/N 

A/N 

A/N 

A/N 

A/N 


SIKH? 


01 SPLAT 
riSPl AT 
DISPLAY 
0 1 SPL AT 
DISPLAY 


‘•cSSi*crl 8 s t> ”*' ,0 *« D > ■*•«« CONTAINS 2000 CNA*»CTMS. NELOSD CONTAINS IDO 


1-9 

-n 

«:tt 

its 

T 3 -M 


? 


A/N 

A/N 

A/N 

A/N 

A/N 

A/N 

A/N 

A/N 

A/N 




8 
81 
Hi lit 


_AT 

PLAY 

PLAT 

PLAT 
PLAT 
PLAY 
‘ AT 
AT 



Reproduced from 
best available copy. 
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in-' 7ii.tr.*, ii-'-t 



ic 

or«K 10 
cc«-..o 
00*9 00 
on. if ».n 

oc^-n ) 
re-* )j 
i>C ^i. O 

CCR**.'J 

0C« fji 
0»:«l >0 


o :i-i 

oop'oo 

OcMOJ 
0043 "J 
QC 3 ) JJ 
00 * ’30 
00» r .>9 
OUJtl J 
001* Jj 
OO’ *J0 
ocJ<no 
O0 W 10 
004030 
nc?4 jo 
Out; nu 
0 3 * c 9 U 
003030 
00 3 ‘ 30 

rc*‘ oo 

0J4 Too 

on*-?3r- 

034»,)0 

O'.’S'-OO 

oc*?on 
005M3C 
0J3| JO 
CCS'nj 

oosroo 
OC*>T30 
00*. coo 

CC* e JO 
007MO 
OJ OO.' O 
007333 

013:00 

0 | 0*>3fJ 

OtCIOO 

01 0*;»0 
L10330 
CC*C.10 
01 IfrOO 
C11500 
ClllOO 
011300 
OlljSO 
017700 
011700 
01 10 30 
01 7000 

ooef no 

037700 

oi e^oj 
Cl no-30 
01 07np 

oi o* on 
01 1 too 
OC$noO 

007030 
C05400 
00 *. *00 
On7-»oo 

C06 300 
004100 

01 uoo 

007100 

007*00 

03».700 

007400 

011700 


03 

03 

03 

03 

03 

03 

03 

03 

0* 

to 

f3 

01 

n? 

07 

01 

02 

0? 

0) 

03 

77 

OJ 

03 

01 

03 

01 

03 

03 

77 

?! 

oj 

0? 

0? 

?! 

03 
01 
0* 
01 

04 


(«x% 

t*»c 

r ms 

f *14 4 -MAST JS 
( .Ufr.MACt JS-1CC7 
C' ; 4-maST |N-CO)E 
(il“ l '- , 4U JS-<C * 

*. U****\TlS.»lFf1 
f l-‘- IN-1 ypf 

C0So-«a^T.j o t 

C !*«- MAST MT-irf ? 

f U<4-MiSiri|?-«e v 
Cult f 8 

r j3t-**4Sinui-ivPF 
nf-si. 
r pr '-p.t yp F 
1SACCT 

!SA"r>9ESS 

I MCI 7* 

ISC O'jE 

I NS AH F 

lN4ff 

INSTATE 

ISTVPC 

|S7|P 

H4sir»-i*« 

«»STf e-OOT 
-AST IS 

2$w N ‘ n -‘ 0U,t ” 

*4SiruT-K> v 

•<astL ir-sA^-Arotus 

njTACCT 

njT403#£3S 

OUT A«EA-<* 

O0IC1 It 

O'JtSAM f 

OjTiEf 

"UTSTATE 

OuTyP E 

0JT71P 

P4FV-H4ST IN 

PQCV>*«4S70U7 

p-fv-kastouf 

p* l v-*4Sirut-4Cf t 

p«Ev«»*4STr''.ii-cpr'€ 

Pit v-«:unuT-*t y 
PPfcV-*ASTPUl-*E7f fi 
p«Fw-**4S»ruT-ttPE 
PBP V-tfc4S$lS 

iiks? nt 

T4CCT-TtPf 

ta* 

TA*T 

t*N 

\r . 
T04DHB6SS 
1P4N-4CCT 
i-an-acCt-w*. 
T9AN-Sfc0-«EV 
tran-Sopt-rev 

iRASS-COOf 
1 R ASS ~|S 

!!J’«T5* , ‘ E - 499, " S 

a 

TRCODF 

TREE 

TRfPFRCNCf 

TRNANf 

nw § 

iu l,p 


«f V 


AllTOFlCw Cm 43 | 5E T - SAMPII SU3IU>3 COHTIl 


>17-717 

l>t-ins 

1 57- 1 M 
140-1*0 

IM-179 

U7-16J 

1 4*- I *3 
717-212 

1PC-71 1 
1*4-10$ 
10“-10» 
113-140 
0-9 
IS- 7 7 

74-97 

74-711 

2*-S4 

17-77 

93-94 

10-11 

95-99 


rii3«-i)4SlpuT 

CUPP-P4SI1N 

CU*-»-KASinuT 


CU39-N4STIN 


rut ft-MAS TfHJT 


S4STIN 


HIE 

h04y|Nr,-U034CF SICTltlN 


P46E' | 

"• V4tU€ 


«AJTfR-|N 


0-9 
54-77 
1 0*-10° 
74-9? 
74-74 
?*-l4 

I?:4Z 

IfcU 

0-15 

lt-71 

?ln-2il 

744-744 



SRJTIN 

••asTfirr 


KAStnut 


>RFV-«US*POT 


T* AN- SORT-REV 


TRANS IN 
TR AN-SL*RT-Rf V 


•UJTC9-CUT 


NO*«IV5-STO!»35fc SECTION 
H43lfB-fl0T 


N r R*l NG-STORAGC SECT J 3N 


TRANS-IN 

NORK INC- STORAGE SECTION 


74-9? 

24-2H 

12-27 

2TU-775 

?S-S4 

93-94 

10-11 

95-99 

248-7TP 


TSAN-SOST-RfV 
TRANS IN 
TRANSIN 


TR4N-S0RT-KCV 

transin 


tran- sort -ret 


TRANS-IN 


WCRR|N?-ST0»4CR SECTION 
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04/fT/TO INPUT LUTING 


AUTOPlON CHART SET - SMH£ CHUT COBOL FACILITIES 


CHART/COBOL - ILIST2I 


CARO NO •••• 


CONTENTS 


1 

I 

1 

« 

I 

A 

7 

I 

t 

to 

11 

12 

It 

14 
U 
1 * 
IT 
IB 
It 
20 
21 
22 
It 
24 

15 
26 
IT 
26 
2R 
SO 
tl 
12 
61 

14 

15 

16 
17 
IB 
It 

40 

41 

42 
41 

44 

45 

46 


PROCEDURE DIVISION. 

NOTE 

R THE HATCHING OF SOTS C GIRLS FOR HIGH SCHOOL DANCE.. 
START. 

NOTE 

I READ FIRST BOT AND FIRST GIRL. 

T GIRL-COUNTER M A COUNTER USfD TO CONTROL THE LOOPING 
THRU THE GIRLS INPUT FILE. 

PRIMARY. 

NOTE 

07 (SECONDARY) PRIMARY MATCH EOUALT. 

I .PUNCH PUNCH DATE-NAME CARO. 

RE4D-4-80Y. 

NOTE 

I READ ANOTHER BOY. 

DY (PRIMARY) I OFT. 

I CLOSE ALL FILES. 

H I NO OP JOB. 

SECONDARY. 

NOTE 

P ADO I TO GIRL -COUNTER. 

ON (PREPARE! ENTIRE GIRLS FILE SEARCHED*. 

READ-GIRL1. 

NOTE 

I RCAO ANOTHER GIRL. 

ON lEOF-GIRLSI EOF*. 

B (PRIMARY) GO TO PRIMARY MATCHING PROCEDURE. 

PREPARE. 

NOTE 

T PREPARE FOR SE CONO ARY * MAT CHI NG PROCEDURE. 

P Cl f AA GIRL -COUNTER. 

REA0-GIRL2. 

NOTE 

1 READ ANOTHER GIRL. 

ON I €0* -GIRL SI EOF?. 

ON (PUNCH) SECONDARY MATCH FQUALt. 

• A 00 I TO GIRL-COUNTER. 

-OY (REA0-GIR12I ENTIRE GIRLS FILE SEARCHE07. 

I PRINT NO-NATCH MESSAGE 'SORRY FELLA* . 

B (READ-A-BOV). 

EOF-GIRIS. 

NOTE 

1 CLOSE GIRLS TAPE FILE. 

I OPEN GIRLS TAPE FILE. 

0 IPR|N t SFC-R(AD-6|RL7l WHICH MATCHING PROCEDURE 7. 

B (READ-GIRL II PRIMARY. 


•• tt 
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OA/.’T/TO 4UT0FL0W CHAR I SE T * SANPLF CHART COBOL FACILITIES 

CHART TITLE - TML HATCHING Pf ROYS C GIRLS FOR HIGH SCHOOL DANCE. 


PAGE 01 



1 01 

/ 

/ 

/ 

✓ 

✓ P f AD F I B s T P"Y ✓ 

✓ AND F I p S T r.|OL ✓ 

✓ 

✓ 

Gin-COUNT* M IS A 

C 1 'UN Tf C US 

0 TO 

C S*N’T B TL T Mf LOOPING 

THRU THf C 

«LS INPUT 

F ILF 

, 

PR I*ARV 

02 

• 

• 

• 

• 

• 

• NO 

• PRI«ABr MATCH • 

) • ‘OUU? • 

• 

• 

• 

• 




VES 

01.15 > 


PUNCH 

Q-\ 

✓ 

✓ 

✓ 

✓ 

/PUNCH DATE-NAME/ 

1 ✓ FARO ✓ 

/ 

✓ 

01.1 A— > 


Rf AO-A-BOV 

06 

✓ 

✓ 

✓ 

✓ 

1 ✓ *T EAD ANOTMf? / 

/ «0Y ✓ 

✓ 

✓ 


05 

• 

* 

• 

• 

NO • 

* 


♦ 

• 

* 

• 

• 

• 

i 



VFS 


06 

✓ 

✓ 

/ 

✓ 

✓CLOSF ALL FILES/ 

✓ 

✓ 

✓ 

✓ 


0? 


• MAI T • 
END OP JOB 


ADD l TO 
GIRL-COUNTER 


• ENTIRE • VES 
• GIRLS FILE • 

• SEARCHED? • 


01 .21 > 

READ-GIRL 1 


to 

✓ 


t READ ANOTHER ✓ 
/ GIRL ✓ 

✓ ✓ 


GO Tn PRIMARY MATCHING 
PROCEDURE 


PRIRARE FOR SECONDARY 
MATCHING PROCEDURE 


CLEAR 

GIRL-C OUNTER 


01. IT* — > < 

RE AD-GI Rl 2 


13 

✓ 


✓ READ ANOTHER ✓ 
✓ GIRL / 

✓ / 


• SECONDARY • YES 
• MATCH EQUAL? 


r\\ 

. 03 . 


ADD 1 TO 
GIRL-COUNTER 


PUNCH 

16 

..... 


• ENTIRE • HQ 

GIRLS FILF • 

• SEARCHED? • 


IS 


✓ / 
✓PRINT NO-MATCH / 

✓ MESSAGE * SCRRY / 

✓ FELLA* ✓ 

/ f 


. 1 . 06 . 

... RCA0-A-BI1V 


— 01.11*— >• 

EOF-GIRLS I 19 


✓ t 

✓ CLOSE GIRLS / 

✓ tape file / 

• / 


20 

✓ 


✓ OPEN GIRLS ✓ 
✓ TAPE FILE / 
t / 


• HAT CHI.... 
♦PROCEDURE? • 


• 1 . 10 . 

... READ-GIRL1 
PRIMARY 



09/08770 


INPUT LISTING 


AUTOFlOW CHART SET - SAMPLE ASSEMBLY PROGRAM 


ASSEMBLY MODULE 


(LfSTl.NAMSOI 


3-59 


e 

9 

10 
1 1 
12 

13 

14 

15 


19 

70 

21 

22 

21 

55 
26 
27 
2 R 
79 

30 

31 

32 

33 

34 
33 

36 

37 
30 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 
61 


7 3 

74 

75 

» 

55 

80 

81 

!! 

85 

86 
87 
M 

89 

90 

31 

93 

94 

95 

96 

97 

98 

99 

°of 

02 

03 

04 

05 
106 
* 07 

08 

09 

10 
11 
12 

13 

14 

15 

16 
I 7 
18 

19 

20 
21 
27 
21 

51 

i‘ 

55 

30 

31 
3? 

33 

34 
15 

n 


OPTION MODACR«YES,OCS*VES,MA£>AP»YE$tHT$U*»VES 


l PP T 
I «=ERa 
T ITIE 
MACRO 
LPRT 
L Cl C 
SFTC 


I 

PN 

1 VfR 1FY 


INVENTORY SYSTEM UPOATES* 


MV 1 

PRBUF+l 

.C* 

ST 

IS, SYS* 

!*<> 1 

MVC 

PPBUP+2 

1 IF 

A IF 

( T ' f.L ENGTF 

**VC 

PP P'JF ♦ 1 

(CL 

AGO 

• AD V 

A SOP 



**VC 

PRBUF* 1 

IF 

A NOP 

A IF 

1 • CACV* 

FC 

A IF 

I ' C AOv • 

F 0 

A I F 

( 'CAOV » 

1 0 

A I F 

1 • CACV* 

(-0 

A 1 F 

< ' C AOV • 

to 

MNOTE 

265. • INVAL 


CLEAR PRINT BUFFER 


•O' l.“H 
H| , LRECCRP 


•0 ( VO 1 01 AO 

•D I VO 1 0 l 50 
IV010160 
| VO 101 70 
I V0101 80 
I VC l Cl 90 
IVC1C200 
I VO 102 10 

IV010220 


PCVE 0 OF BYTES SPECIFIED 
RO MOVE ACCOROING TO l» 


1*1 • A DV 1 
2 * I • A CV 2 
3* I • A CV 3 
E ' I .ACVEJ 
-- E JECT • I. ACVEJ 
INVALID PRINTER ADVANCE SPECIFIED* 


• AOV 1 

M V ] 

PPRHF • X *09 • 


AGO 

.Cd“MCN 

• ADV2 

M V l 

PR4UF,X»li* 


AGO 

.CCMMQN 

• *DV 3 

“VI 

PRfHiF.X'19* 

.AOVEJ 

AGO 

•CCMMCN 

M V I 

PR 8UF . X 1 09 • 

•COMMON 

ANOP 


L 

13.*A( SAVEAREAI 


PUT 

ERROR, PRBUF 


L 

MEND 

MACRO 

15.SYSPEG15 

CNAME 

RES 

CVAR 

CNAME 

MV! 

MEND 

MACPC 

CVAR.X'OO* 

CNAME 

SET 

CVAR 

CNAME 

M V I 
MEND 

CVAR.X'FF • 


MACRO 


CNAME 

I P8RR 

CUE S T 

CNAME 

CL I 

IPERRPP.X'FF* 


BE 

MEND 
MAC RC 

CDE ST 

CNAME 

C IEPR 


CNAME 

Cl I 

I PERKPR , X • FF * 


BE 

SAC S Y SNOX 


LPRT 

INAPEAPR, 1,120 


SET 

I Pf R RPR 

2CSYSN0X 

OS 

OH 


USING IV01PJ8.il 
GET INPUT. INAREA 
PIS IFERRPR 
CLEAR OUTPUT RECORD 
“VC OUTPCCCE. SPACES 
OUTNCCOE 
OUTOCOOE 
GUTCCODE 
OUTNAMF. SPACES 
CUTVOL .»P»0' 

I AC ODE » C' 0* 


RES 

RFS 

RES 

M VC 

ZAP 

CL1 

Bl 

BE 

CL I 

85 

CLI 

Si 

L PR T 
IP»T 
l PRT 
R 

EJECT 
OS 


ucnof .C'2» 

NAMCHG 
•NVINC 
ACODE ,C*4» 
NVOEC 

1NAREAPR, 1,120 
MAIN 


nCFSSING^FOR p INV|NTCRY I NCRE ASE/ CECR EAS E 


CLC 

BE 

C IE PR 
L PRT 
LA 

C NOP 

BAl 

DC 

DC 

L 

ZAP 


MESS 1 1 . 1 
• 1INC10 


iU' 


1 » •♦ 1 2 

hi. 


A ( I PVC_ 

ai voldEc I 

1 5. ■ V C OECC VT I 
VCLOFCt-P'O* 

IINC20 
I INC 30 
I AC DOE ♦ C* 3* 

I INC60 

OUTVOL.VOIOEC 
HASNTOT.-PM* 
•♦10 
3. WRITE 
3 

A5FN0 4000. CUPP 
C IE PR 

" M£SS 14.1 
t INC50 


C 

BL 


BC 

LA 

BR 


L PRT 

d 

CIEPR 
L PRT 
B 

SP 

E OU I Nv'I NC 
EJECT 
DS OH 

PROCESSING FOR OFLETE PRODUCT CODE 
" r IPNA-E. SPACES 


OUT VOL • VOLDEC 


DEL05 
DEL 10 


DEL 30 
DFL15 


CLC 
BNE 
C IFPR 
L PRT 

i* u 

?s E 


nusfficcv. 

( 15I.HPVCL. 
15.-F *0* 


VOlOECt 



DELI 5 

f PR 
IPKT 
C 

BE 

IPRT 
SET 
BC 

EJFCT 
DS OH 

PROCESSING FOR ADD 
SET OUTNCCOE 

CLC I PNAME. SPACES 

BE ADD 10 

L IS.rVICECCVTl 

I 151 . 1 I PvCl . VOLOECI 
15. ®F *0* 

WRITE 


CALL 

C 

BE 

CIEPR 

LPRT 

C 

BE 

LPRT 

B 

C 1 1 PR 
LPAT 


MESSUR.l 
1 5 • «F • 4 1 
MPITE 
NESS06.1 
MP1TE 

MFSS07.1 


02 30 
-C240 
VO 102 50 
V010260 
0270 
0280 
0290 
0300 


V010310 


SI18 

0340 

0350 

8118 

0380 

0390 

10400 


...0430 
VO 10440 
V010450 

IVO 0460 
VO 0480 
VO 0490 
VO 0500 
VO 0510 
VO 0530 
V010540 
VO 0550 
VO 0560 
'10580 
. - 0590 
VC10600 
VO 06 10 
‘ 0620 
0640 
0650 
0660 
0670 
0680 
.06 90 
10700 
10710 

8518 

0740 
.0760 
10770 
r 0780 
0790 
0800 
0810 
0820 
0840 

8818 

0.70 


VO 

VOi 

ivoi 


BM 

8??8 

0940 

0950 

8388 

0980 


40 

888 


( VOI 1 130 

IvoilioS 


von 760 
VOI 1770 
VOI 1 790 
V011780 

voiieoo 

VOI 1 630 
V011840 
VOI 1850 

I VOI 1 920 
I VOI 1930 


VOI I860 
VC1 1940 
V011810 
VOI 1 820 


S- 60 


INPUT LISTING 

• ••• 


AUTOFlCw CHART SET - SAMPLE ASSEMBLY PROGRAM 
CONTENTS •••• 


IS* 
1S5 
I Sft 
1ST 
1S8 
1 59 
I 60 
161 
162 
16 * 
i 6* 

165 

166 

167 

168 

16 5 
1 70 

171 

172 
175 

1 74. 

1 75 
1 76 
177 
1 78 

17 9 
180 
18! 

18 2 
1 83 
I 8* 
185 
1 86 
187 
1 88 
185 

1 50 
191 
19? 
193 
19* 

195 

196 

197 

198 

199 
?00 
201 
702 
203 
20 * 

705 

706 

707 
208 

709 

710 

711 

712 
21 3 
21* 

215 

216 

217 

218 
219 
270 
221 

227 
223 
22 * 
275 
226 
277 

228 

229 

230 

231 

2 32 
233 
2 3* 

235 

236 
737 
7 3® 
239 
7*0 
2*1 
2*2 
2*3 
7** 
2*5 
2*6 
2*7 
7*8 
7*9 

250 

251 

252 

253 
75* 
235 

256 

257 
2 58 

259 

260 
261 
262 
263 
26* 
765 
266 

267 

268 

269 

270 
771 

272 

273 
27* 

275 

276 

277 

778 

779 
78C 
281 
2B7 
283 
28* 

285 

286 
287 
286 

289 

290 

291 

292 

293 

294 

295 

296 
757 
798 

299 

300 

301 

SO 2 

103 

304 

.305 

306 


cu 

sr r 

RNF 
UFPR 
LP»T 
t 

CALL 
C 

BE 

C If PR 
L PR T 

C 

BE 

LPRT 
B 

EJECT 
"VC 

*vc 

RANGE test 


B A0015 

EJECT 
OS OH 

PROCESSING FOR NAME CHANGE 


1 V01 1 2 10 
I VO 1 1960 


1 PNAMf , SPACES 

O'JTCC 00c 

KAMI 0 

MESS09.1 
1 5. « v | OECCYT I 
US). I IPVCl.VOlCECt 
13. -F *0* 

WRITE 

MESS10. 1 
15,-F*4* 

WRITE 

MESS06.1 

WRITE 


Chap 

Cham 

Chap 

Cham 

Char 


5 

- 7 
0 

CL 1 

BC 

Cll 

ec 

lm 

CLI 

BL 

Cl! 


CUTNAWE .IPNANE 
OUTPCCDE, 1PCC0E 
PPCDUCT COOE 
A - I 
NUMERIC 
0-5 
NUMERIC 
ALPHA 

I PCOOE .X*C1* 

A. WRITE 01 
I PC ODE • X 1 C9* 

2.WRI TEOl 

3. 5* «A1I PCCOEM.l. IPCOCEOl 
01 31 . X*FQ* 


WRITE01 
3*4* wR ITEIO 
l PC POE *4 .CO* 

WR 1 T £ *4 
I PCOOE *4. C *5 * 
wR ITf 11 

I PC OOt ♦ 5. X *F0* 

WR |T E01 

I PCCDE»5»X , F9* 

•♦8 

WRITE31 
1 PCOOE *6* X*FO* 
wRITEOl 

I PC GOE *6 » X* F9 • 

WRITEOl 

I PCOOE ♦ 7. X*CO • 

WRITEOl 

I PCCOE *7. X*FO * 

WK1TE01 
I p ER R INERRCR 

w°!TE OECB.SF. OUTPUT. CUTAREA, 100 
CHECK DECB 
B MAIN 

IFfRR WR 1 TE 02 
LPRT I NARE APR. 1.120 
SET | PER R PR 


BXLE 

CLI 

BL 

CU 

P.H 

CLI 

BL 

CLI 

BNH 

8 

CLI 

PL 

Cll 


PNC 

CLI 

BL 


WRITE** 

WRITE11 


ECU 

EJECT 


MESS03.1 

MAIN 

WRITF26 

WRITEOl 


INARE APR 

CC 

CL40* • 

1 NARFA 

OS 

0CL80 

i AcnoE 

DC 

CLP * 

I PCODE 

OC 

C10' • 

| PNAME 

DC 

C L 50 ' • 

I P VOL 

DC 

CLIO* • 


OKG 

1 N AR E A *60 

OU T AR E A 

OS 

OCL 1 00 

0UTPC1DE 

DS 

CLIO* • 

CUTNCnOE 

OC 

CLI* • 

nuTocnnE 

OC 

CLP • 

OUTCCODE 

DC 

CLI* • 

OUT VOL 

OC 

P* 0000000000 

Outname 

OC 

CL50* * 


PRO 

CUTAREAMOO 


SPACES DC 
SPACE ?0U SPACE 5 
PL AN* EOU SPACES 
OC P* 00000* 


MAShTOT 
| PtRRPR 
SYSRFG15 
VOICE C 
PMEUF 

MESS01 
MFSS02 
»*E SS03 
ME SSO<* 

ME SSG5 
Mf SSP6 
ME SSO 7 
Mr SS08 
ME SS09 
Mf SSIO 
ME SSI 1 
M F SSI* 


INPUT 

ERROR 

OUTPUT 


DC 
OS 
CC 
OC 
EJECT 
DC 
OC 
OC 
OC 
CC 
DC 
or 


X' __ 

IF 

P’CCCCOCOOOO* 
Cl 121 * • 


OC 
DC 
CC 
OC 
OC 

ITC.RG 
FJECT 
PRINT NOGEN 


INVAL 10 

ACTIVITY 

CODE ' 


PMCGUCT 

NAMJ 

NTT 

SPECIFI 

FD 

PI-CUUC T 

C ICE 

NJT 

ACCEPT/ 

Dl E 

product 

QUANT ITY 

IS N'H 

A V 

P M .TUC T 

JUAN 

! TV 

NOT V At 

10 

PRODUCT 

C JANT 11 V 

F If LD 1 

S 1 

PM.DUC T 

\S-f 

NCT 

SPECIF] 

10 

PRODUCT 

UJJ'.' 

1 1 V 

NTT VAl 

1U 

fVCDUCT 

NA*i 

NU 

SPECIF] 

t u 


VALIU NUMBER* 


OCR 
OCP 
TCP 

PRINT GEN 
EJECT 
ENTRY 1V01EP 
OH 


CSCRG«PS.MACRF»GM,FOOAD«EOJ. lRECl«80.D0NAMf. SYSIN 
CS« •JG»PS.MACRF»P* , .LRECL«121 »PECF“«FP.M, CCN AME- ERHPRNT 
CSORG«PS. MAC R F» I WP 1 .6LKS1 Zfc* 100. RECFM*U. DDNAME-OP 


OS 
SAVE 
ORCip 
PAIR 
USING 
ST 


DROP 

USING 

OPEN 


t i.t 12 r mituiiimiw 

11 
2.0 
•.7 

13.SYSREG13 
19.<A(SAVEARFAI 
1 1 » • A ( I V01PJBI 
2 

I V01PJB.1 1 

I INPUT, ( INPUT), OUTPUT. (OUTPUT! .ERROR. ( CUT PUT 1 1 


LOAD COVER REGISTER 


USING 1HADC6.3 
L 3 • « A 1 CUT PUTI 

TN OCBDFLGS.X'IO* 

IMT01 

•UNSUCCESSFUL! OUTPUT OPEN* 

4, DUMP 
3 »»A( INPUTI 
OCbOF LG S. X* 10* 

IN1T02 

•UNSUCCESSFUL! INPUT CPEN* 

8. DUMP 
3. * A I E PROP I 
OCBOFLGS.X’IO' 

MAIN 

'UNSUCCESSFUL! ERROR PRINT OPEN* 


SYSREC13 DS 
SavEAkU OS 


eo 
WTO 
A3EN0 
L 

TM 
BC 
wTC 
ABEND 
L 

TM 

BC 
WTO 

ABEND 12. DUMP 
OS OH 

END CF FILE ROUTINE 
CLOSE INPUT 
CLCSE OUTPUT 
CLOSE ERROR 
L 13.SYSREG13 

RF TURN 114,12) 
SPACE 


EJECT 

OCPD 

END 


I* 


8F 


OSCRG-PS 

IV01EP 


i vo 

IVO 
I VC 

i vo 

I VO 
IVO 
IVO 


1960 

1990 

2000 

im 

2030 

2040 


IV012120 

1V012130 


VC11T20 
VO 107 30 
VC1073S 
VO 1 1 740 
VO 1 1680 
VOI 1690 


ACTIVITY CODE 
PRODUCT COOE 
PRODUCT NAME 
PRODUCT ACTIVITY VOLUME 


PRODUCT CCDE 

SET TO x * F F * FOR NEw PROOUCT 
SET TO X * F F • FOR PRODUCT DELETE 
SET TO X • FF • FOR NAME CHANGE 


ADO' 

. H AOO* 

- - FU« NAME CHANGE* 

PPtUUCT CU ANT 1 T Y NOT VAtlD WITH NAME CHANGE* 
PPCDUCT NA Mf nuf VALID FOR INV INC/OEC* 
PRCDLCT QUANTITY ZERO FU« INV INC/OEC' 


IVO 2380 
IVO 2390 

!8 life 

IVC 2420 
IVO 2430 
1VC12440 
IV012450 
I V012460 


2470 

2480 

2490 

2500 

2520 

2540 


2560 
V012570 


2580 

2550 

2600 

2610 

HIS 


VC 1 2650 
V012660 


m 


1 V012T40 



c«; /c#»/7c 



PK n C FDUAAL 

ST A 1 F “t NT LAP 

EL INLE* 

AUTOFL^to CHAM SET 

- SAM.HE 

ASSEPBIV 

PROGRAM 


1 , Pl 

NAME 

PG.RI 

NAMf 

PG.R1 

NAME 

PG.81 

NAME 

PG.BX 

NAME 

.16 

ACfKAf R 

2. 16 

OfllC 

2.01 

1 1 NC ?r 

*.01 

1 VOlf P 

3.13 

WRITE 

• 1 * 

ATC 

2.21 

Cf L 15 

2.0* 

I INC 50 

1. 06 

IV01PJB 

3.22 

WRITE 01 

.?« 

ipr C5 

2.20 

0EL20 

2.11 

I |\Cf c 

1.09 

MAIN 

3.25 

WRITE 02 


ADC10 

2.22 

Cf l 30 

1.16 

INfRkU* 

1.CI 

NA“CHG 

3.17 

WRITE10 

.21 

Af>0 1 5 

*.17 

EO J 

* .09 

INI f 01 

3.05 

NA**05 

5.03 

WRITE 11 

.25 

AC030 

1.0* 

1IKCC5 

*.13 

1NIT02 

3.06 

N AMI 0 

3.33 

WRITE20 

*.05 

MAN* 

1.06 

1 INC07 

5.01 

INVDEC 

3. 10 

NAM30 

3.30 

WRITE33 

.13 

DEL 

1.07 

11NC10 

1.01 

1 N VI NC 

5.0* 

SPACE 

5.02 

WRITE** 

.15 

DEL05 

2.09 

1 IKC20 








PAGE 


“ 3-61 





PAUt 


• 3-62 


CAAO 10 PAGE /BOA REFERENCES 1 SOURCE SEOUlNCt NQ. ANO PAGE/60*) 

ASSEMBLY MODULE ASSEMBLY PROGRAM 


CHART TITLE - 'VERIFY INVENTORY SYSTEM UPDATES* 


(000095) 

1.01 

INVINC 

1 VO 10890 

1. 14 

(000117) 

5.01 






(OC0090) 

1.04 

1 INC05 

(000086) 

1.01 








10000951 

1.C6 

IINCOT 










(0000961 

1.07 

I INC 10 










1 VO 107 30 

1.C8 

1 V01PJ9 










IV010760 

1.09 

MAIN 

I V010980 

1.18 

(000217) 

3.25 

I V01 1740 

3.35 

(000269) 

4.14 


I VO 1 0950 

1.16 

ACERROR 

I VO 1 0860 

1.13 








IV01C97C 

1.19 

TNFRRCR 

1 VO 1 1 72 L' 

3.33 








IV011770 

1.19 

ACC 

IV010660 

1.13 








1 VO 1 1 A 30 

1.21 

ACC15 

(000154) 

1.29 








IV 0 1 1 930 

1. 25 

ADD3C 










IV01I810 

1.28 

ACC10 

IV01 1780 

1.20 








I VO 1 1 820 

1.29 

AD005 










1 00011 2 1 

2.01 

1 INC 30 

I000C99) 

2.C3 








(000105) 

2.06 

1 1NC50 

(000114) 

2.02 

(0001111 

2.10 

(000116) 

2.11 




(0001091 

2.C9 

1 INC 20 

(0CC098) 

2.03 








(000115) 

2.11 

I INC60 

(000101) 

2.04 








(000108) 

2.12 


(000105) 

2.07 








IV0UO20 

2.13 

DEL 

1 V010920 

1.15 








I VO 1 1 060 

2.15 

OE 105 










tVCIlORO 

2. 16 

DEL 10 

1 V01 1030 

2.13 








IV0U180 

2.20 

0EL20 










IV01U30 

2.22 

0EL30 










tVO 1 ) 190 

2.23 

Of L 1 5 

IV011100 

2.18 

(000131) 

2.21 






IV011970 

3.01 

NAMCHG 

IV010690 

1.14 








IVOI2020 

3. C5 

NAM05 










1 VO 12030 

3.06 

NAM 10 

I V012000 

5.C3 








I V01 i 1-30 

3.10 

NAM30 






_ 




IVO 11230 

3.13 

WRITE 

1V011850 
I 000165) 

1.23 

3.08 

(000148 1 
(000169) 

1.26 

3.11 

IVO 11940 
IV012140 

1.27 

3.12 

(COO 107 1 

2.06 

IV0U200 

I V01 1 380 

3.17 

WRITE10 

IV0U420 

3.19 








IV01 1680 

3.22 

MR ITE01 

t V01 1330 
1 VO 1 1 520 

3.14 

3.28 

1 VO 1 1 350 
1 VO 11550 

3.15 

3.30 

I VO 1 1 380 
(0002051 

3.17 

3.31 

1V011400 

(000207) 

3.18 

3.32 

1 V011480 
1V0U22O 

ivomio 

3.25 

WRITE02 

IV011680 

3.22 








IV0U520 

3.28 


1V011500 

3.27 








IVO 11550 

3.30 

MR1TE33 

(000200) 

3.27 








IV0UT20 

3.33 

WRITE 20 










1V0126C0 

4.01 

IV01EP 










(000263) 

4.C9 

INITOl 

(000279) 

4.06 








(000269) 

4.1) 

INIT02 

( 0C0284 I 

4.10 








(000296) 

4.17 

EOJ 










CHART TITLE 

- ECU 

STATEMENTS 










IOCOUTI 

5.01 

INVDEC 

IVO 109 20 

1.15 








(000216) 

5.02 

MRITE44 

I VO11440 

3.20 








IVO l 1 220 

5.03 

MRITEli 

IV011460 

3.21 








(0002)7) 

5.04 

SPACE 










(000238) 

3.05 

BLANK 











CHART TITLE - CONSTANTS ANC STORAGE AREAS 


ASSEMBLY MOOULE ASSEMBLY SUBROUTINE 


CHART TITLE - 'CONVERT ALPHA FORMAT NU M GER TO CECIPAL' 


(000002) 

7.01 

OECCVT 

I V011840 

1.22-X IVO l 1090 

2.1 7- X IVO 12040 

(000010) 

7.C5 

C HK 00 

(000022) 

7.13 


(000016) 

7.08 

CMK02 




1000016) 

7.C9 


(000012) 

7.06 


1000018) 

7.10 

CHK01 

( C00010) 

7.05 


I0C0070) 

7.11 

CMK03 

(0000141 

7.07 


(000021) 

7.12 

CHK04 

(000019) 

7.10 


(000032) 

7.16 

EKIT 

(000030) 

7.16 




DIAGNOSTICS 

DIAGNOSTIC 


r«»^CA/?o T A ill F OF 

ter ATIuN 

caod n PA&f/nax 
fOOOCK7l 1.07 

10002121 5.02 


ONCCflNFO - 'BEG • VALUE * 
UNUEUMO - » WR| T £ 26 • 


AUT UFLCJW CHABT SET - SAMPLE 


3-63 

F*6E I 



S- 64 


C9/CB/70 

CHART TITLt - ‘VERITY INVENTORY SYSTEN UPDATES* 


AUTOFIOM CHART SET - SANPLE ASSEMBLY PROORAN 


RAM Ol 


/ 1V01PJ6 / 


01. IB*— > 
MAIN 


sm c i . . . : 


/"' ' ”7 

/ / 

/ GET / 

/ INPUT, INAREA / 

/ / 


1 1 V010770) I 10 

’ "res Iperrpr 


CLEAR OUTPUT RECORD 


T 


I ouTPcaolfs»«C(S j 

RES 

OUTNCOOE 

RES 

OUT CCOOE 

REG 

OUTCCOOE 


01 • 1 4 •—>•<— - 

PROCESS! NR FOR 
INVENTORY 
INCREASE /OFCREASF 


EQUAL * CLC • 
* I PKAME, SPACES • 



UNEOl 

ICOOOAM 1 

02 

i Cippp l 

*0000891 

03 

/ / 
/ / 
/LPRT NESSM.l / 

/ 

II NCOS 

04 

{ IA 14.I1NC1C I 

*0000921 1 

1 

05 

! o»i i 

l.**12 1 

IINC.O? l 

' 0. 

1 n.-vibcccvn 1 

live 10 
........... 

07 


f AP 

vniofc.*p*o' 


••• &FG. VALUE 
BR IS 


UV010B40II 12 

• .... * 

MVC 

CUTNAHE. SPACES 


LOW * * EOUAL 

• CL I • 

• i ACODt »C ' 0* • 


* A 

Ielsf 


( I V01 CR90 I • 14 


EOUAL • • LOW 

* • I ACOCE *C* 2** *~l 

I 


( I V010920 1 • 15 


EOUAL • • LOw 

„ CLI 

*1 AC00E,C*4** I 


: ii 

DEL* 


ACE 030® 

/ 


ELSE . 5 . 

. 01 . 


INVCEt 


16 

"/ 


/ / 
/ LPRT / 

/INAR|APR,l,120 / 

/ / 


nvoio«j60» I 

/ 


17 

/ 


/ / 

/LPRT PESSO 1. 1 / 

/ 


INERRCR I IB 

/ * 7 

/ / 
/LPRT SPACES* 3 / 

/ 


. 1.09. 

• • • HA| n 


PROCESSING FOR AOO 

IIVOI|T90)T_ 19 

I SET OUTNCOOE I 


I I VO 1 1780 


• CLC • EOUAL 
• IPNANE, SPACES • 


| i5,»vibEccvn__ | 


( CECCVT I 

15»?fUvOL 

VOLOEC) 


• c * IS ** 1 

• 15,»F‘0* • I 


UNE9L ,”J*. 
• 1) • 


mr!H 


UV0U92DI | 

i CIEPr’ 


ADD TO 
/ 


24 
— • 
I 


25 

/ 


/ / 
/LPRT 9ESS08 * 1 / 

/ 


10001481 • 26 

• • 

• • 

• ^ • EOUAL 

• 15, »F *4* • I 


UNEQL . 3 . 

• 13 . 


UV01 18801 
/ 


VRlf? 


27 

7 


/ / 

/LPRT NESS06.1 / 

/ 


— ->• 

A 0010 | 


A0005_ 

r 


28 

— 4 


24 


^/LPAT NdSOTty' 


>. 13 . 


WRITE 



C1/CA/T0 

*Ufl)flO« CHART SET - SAHPLE ASSEMBLY PROCRAN 

fMART tIUE - 'VERIFY I NVENTC? Y SYSTEM UPCATEf 


3-65 

PACE 02 


.IINCIO I 01 

i t»;; * 

• — ---- - — — 

<0001111 I 02 

/ / 

/l PRT Ml 5 506.1 / 


/ <0000181 / 


HIGH • * LQy 

• # * 


ACOotlc'S** * 


_<000103l 

UNECL 

cs 

| * AP j 

| CUTVOL * VCL CEC ) 

-02. 0?*— > 


I 1NC50 
• — ... 

06 

1 HASHTOT.-PM • j 

<0001031 < 

07 



N/OVF 

^ < 0001061 l 

Cfl 


L* J.W|TE J 


• Ml! 

• •• write 
e* s 


• _ii NC2 ° 1 09 

i ClfcPR | 


tooonoi I to 

' / 


MNC6o’ > * 11 

$P * 


>• 

1 12 

*- H * lT * 

ABCNO 9000 « DUMP 


/ P EL / 

01.13 >• 

PROCESSING FOR DELETE 
PROOUCT CODE 

• 

UVOUGljli ^ |5 

UNEQL • * CLC * • 

♦ • I P KAME* SPACER • 


HESS14.1 / 
/ 

/ 


EQUAL 

T’~ 

CIVOl 10401 

14 

••• 

i i 

2.06.* 


' 

• •• 1 1 NC50 

DELOS 

19 


/ / 
/LPRT NESSOIU / 

t / 


I OUT VOL 01 DEC J ! j * '«»< kgCC VT I j 


1 1 VO 11 090) | 


IT 


icfccvn n 

1131 if fc^VOL • N 
VOLDECI N 


I IV0I1100I 
E QUA ^ 


It 

w * 

• • 

• • 

• l5,-f*0* • 
• • 

• • 

UNEQL 


ill gj 1**01 1 If 

J CII W | 


0EL20_ 

/ 


It 


/ /' 
/LPRT NESS03* 1 / 

' / 


' I 

10001311 * 


<0001311 * # 21 

EOUAL • * * • 

< • C • 

* 1S,-P*4* • 


t UNEQL 


DEL 30^ 
/" 


/LPRT KESS04.1 / 

/ 



n 

1 SET OUTOCOM 1 




3* IS* 

unite 



3-66 


09/C8/7C 
CARP 10 


> USAG£_iU8H^jr 



“AlfRRORJ 
• A I INPUT) 

*A( 1 PC ODE* t « 1 • I PC COE *3 I 
“A( IVOIPJBI 
•AIOUTPUTI 
* A ( SAVCAREA) 

“F'O* 

-f '4» 

-p»0» 

»p» 1« 

“VI OECC VI I 


INVOCATIONS I SOURCE SEQUENCE NO- 1 


•uronon chart set - sample ‘ assenslt program 


ll IBRARV) 

ABEND 

1 000108) 

(000282) 

li IftRARV) 

C.AI l 

! *01 i 090 

1V01 1840 

(LIBRARY) 

CHECA 

IV01073S 


(l IRRARVI 

C IEPR 

10000881 
(VCl 1120 

10001091 
IV01 1810 

IL IBP ANY) 

CLCSE 

( 00029 S ) 

IC00296) 

IL 1 BR ARY) 

DCS 

IV012500 

I VO l 2 520 

It I8CARY) 

GET 

IV01C760 


IV01C590 

IFERR 

1V011680 

IV011720 

U 1 RRARV) 

t PRT 

1 CP0089I 
1 VO 1 09 SO 
I V01 1690 
1 V012080 

(ooouoi 

1 VO 1 0960 



I VO 1 1 710 
1 V012130 

(LIBRARY) 

OPEN 

IV012680 


(LIBRARY) 

PUT 

IV01C45C 


IV010490 

RES 

1 V010770 

IV010800 

ILIBRAPVI 

RETURN 

( 0002991 


IL IBPARV) 

SAVE 

tvomoo 


IV010540 

SET 

IV01C690 

1 VO 1 1 1 90 

(LIBRARY) 

WRITE 

IV010730 


(LIBRARY) 

WTO 

10002811 

( 00028(1 


10002871 
1 V012040 

100011?) 
1 VQ1 1920 

C 000297 ) 
l VO 12540 


I ooon JJ 
I VO 1 0970 
1 VO 1 1820 


IV010810 


I V 0 1 06 SO 
I VO 1 20 10 


I VO 10 1 BO 
I V01 1060 

ivoneeo 


1 V010820 


IV011790 


I V01C650 
i V0I2120 


IVO1O10O 
ivoupo 
1 V01 1930 


1 VOX 1 990 


AUTOFLOw CHART SET - SAHPIE ASSEF8LY PROGRAM 

references i source sequence nc.i 

1000288) 

(000283) 

IV011370 

IV012660 

(000270) 

IV010440 1V0126S0 

(0001651 IVOIUOO IV01X890 

I000C961 .000131) 1 000196 ) .0001491 

1000096) I V010850 

(000104) 

.00009 SI I90U000 19011030 19012030 


09/C8/70 

TAG 


^D^PjEOjrAGSU^^ 
CPE RAND 


INAfi f A*80 
IPCOCE* l 
1 PCQC£»3 
IPCOOE44 

IV012220 
IV011370 . 
IV011370 


IPCOOE45 

IV01 1440 

IVOl 1460 

IPCOOE»6 

I VOX 1480 

IV011500 

IPC00E6? 

IV01 1520 

IV0XX540 

10002051 

(0002071 

RUTAREAMOO 

PRBUF*1 

1V012310 

IV01C210 

1 V0X0220 

PRPUF+KtFUOCECRECCROI 

IV01C270 

PRBUF»1 ( ti ENGTH1 

1 vox 0240 


PRRUF*2| (FUDGE- PR BUF~2 1 

IV0XO220 



AUT0P109 CHART SET - SAMPLE A5SEM0L9 PROGRAM 
REFERENCES (SOURCE SEQUENCE NO. I 


3-67 


09/10/70 

INPUT LISTING 


AUTOFLOM CHART SET - SAMPLE 

ASSEMBLY WITH CHART COOES 

CHART/ASSENBLY 

1L1ST11 





CARO NO 

• ••• 


CONTENTS 



1 

CVT 

TITLE 

•CONVERT ALPHA FORMAT 

NUMBER to DECIMAL* 

RV 

0010 

2 

* 



(0ECCVT1 

en 

0020 

1 

CECCVT 

CSFCT 


ROUTINE ENTRANCE POINT 

T 

0030 

4 

» 

6 


SAVE 

USING 

ST 

119.121 

OECCVT.ll 

l.SYSREGl 



00»0 

0050 

0060 

7 


L 

2.011 ) 



0070 

8 


MVC 

INVALUE, 0121 



0080 

9 


L 9 

3,5, «A( INVALUE. 1. INVALUE + LM NVALUE-l 1 


0090 

10 


LA 

6. tNVALC 
0! 31 ,X»40* 



0100 

11 

CHKOO 

Cl I 

VALIDITY CHECR ALL DIGITS 

p 

0110 

12 


8 6 

CHXOl 

AND LEAOING 2ER0 FILL FIELO 

c 

0120 

13 


CLI 

0(3) .X«FO* 
CHK02 



0130 

19 


5L 



0190 

15 


CLI 

0(31, X*F9* 



0150 

i 6 


9NH 

CHK03 

ALL DIGITS VALID DECIMAL 
SET RC » 8 

CN 

0160 

17 

CHK02 

L 

1 5.»F*P« 

p 

0170 

18 


RETURN (19,12t,RC»ll5) 


EV 

0180 

19 

CHK01 

MV! 

0161. C'O* 



0190 

20 


q 

CHK04 



0200 

0210 

21 

CHK03 

MVC 

01 1 ,91,0(31 


N 

22 

CHK04 

L a 

6. 116), 0(31 



0220 

23 


8 XLE 

3, 9, CHKOO 



0230 

29 

• DATA HAS NOW 

SEEN VALIDITY CHECXEO 


C 

0290 

25 


PACK 

OUTVALD , INVALC 

CONVERT VALUE TO DECIMAL 

P 

02 50 

26 


L 

l.SYSREGl 


• 

0260 

27 


L 

2,91 1 1 



0270 

28 


MVC 

OIL* OUTVALD, 21, OU TV ALC 



0280 

29 


SR 

15,15 

SET RC - 0 

P 

0290 

30 


AP 

OUTVALD, «P*0* 

IS VALUE ZERO 

CN 

0300 

31 


82 

EXIT 


C 

0310 

32 


LA 

15.9 

SET RC - 9 

P 

0320 

33 

EXIT 

RETURN ( 19,121, RC-I 151 


EV 

0330 

39 


SPACE 

6 



0390 

35 

39 

INVALUE 

INVALC 

OS 

OS 

CL8 

CL8 



0350 

0360 

37 

outvald 

DC 

p* 0000000000* 



03 70 

38 


SPACE 

3 



0380 

39 


END 




0390 


|0/T0 


lAT 




AUTQFLOW CHART SET - SAMPLE ASSEMBLY HUH CHART CnOEJ 


PAGE 


TLE 'CONVERT ALPHA FORMAT NUMBER TO DECIMAL* 


/ DECCVT / 


ROUTINE ENTRANCE 
POINT 


CHKOO I 


01 


VALIDITY CHECK 
ALL DIGITS AND 
LEADING ZERO FILL 
FIELD 


* 02 

• • 

• • 

*ALL DIGITS » YES 

* VALtD DECIMAL * 

* • 

• • 

• • 

j NO 


CHK02 

* 

I SET RC ■ 8 j 


03 


0* 


* EXIT 


RETURN 

(14,121, RC«flSt 


>, 

CHK03 I NOTE OS 
• »*••*•••»* 

» DATA HAS NOW BEEN * 
* VALIDITY CHECKED * 


06 


CONVERT VALUE TO 
DECIMAL 


SET RC » 0 


OT 

— *. 


* 08 

• • 

• • 

YES • * 

* IS VALUE ZERO • 

* • 

• » 

• * 

I NO 


09 

SET~RC * _ 4 I 




EXIT I 10 

* Ls , t _ * 

RETURN 

I 14, 1 2) , RC* ( 1 5 1 



09/ IT/ Jo INPUT LISTING 

•SSfNSLY MOGUL £ II I STI .NAMSOI 


AUlnfUlK CHART SET - SAMPLE ASSEMBLY PROGRAM 


3-69 


CARD NO 


♦ 0 

41 

42 
A3 

4.4 

45 

46 

47 

*s 

49 

40 

5) 

4 ? 

44 

44 

44 

47 

56 

59 

60 

Si 

63 

64 
64 
66 
67 
66 

69 

70 

1i 

T 3 

74 

75 

76 

77 
76 
79 
60 
61 
62 

63 

64 

65 

66 
87 
66 
49 

90 

91 

%\ 

94 

95 

96 
07 


PITE 4 VC OUTNAMF , f PNAME 
*VC HUTCOOF. fPCOO? 
RANf.F TEST PRODUCT CODE 
CHAR 1 A - 1 

CHAR 2-4 NUMERIC 

CHAR 5 0-5 

CHAR 6-7 NUMERIC 

CHAR R ALPHA 


CL! 

ec 


bc 

Ki 

Bl 
CL! 
6 H 
«*l P 
CLI 
BL 
CL I 
BH 

CL! 

BL 

CLI 

BNH 

B 

CL! 

PL 

Cl! 


IPCOOF.X'CI* 

4 .WRITP 01 

I PCDDF • X' C 9 ' 
2 .WR 1 TP 01 


•AC 

•c 


PRODUCT TTM SURF! ELD 


fcSi;iiw™ nti * iwoofMi 

MRITPOI 


WRITF 33 BH 
T •* 
BNO 
CLI 
BL 


0 I 3 ).X'F 9 » 

WR I !► 01 

WRITP 44 

!PC DDE » 4 « C * 5 * 

H 0 ITC 11 

I PC D 0 E* 5 .X*F 0 » 
HRITFOl 

I °CODE* 5 * X'F 9 # 
•♦8 

HP 1 TF 33 
IPCODE» 6 ,X'F 0 » 
HR ITE 01 

!PCnnF* 6 ,X»F 9 » 

HRITFOl 

I PCODF + 7 * X 'CO • 
HRITFOl 

IPCOOF 47 ,X'FO» 

MPITEOl 


PRODUCT^NUHBEA SURF I EL 0 


DIVISION t SUBFIELD 
0-57 


PLANT • SUBFIELO NUMERIC? 
RESEARCH DIVISION 
SUBFIELO ALPHABETIC? 


HR ITE 20 

HRITE 01 

HRITE 02 

WRITE 44 

HRITEll 


IFFRR INERPOR 

CHECK g|^» SF » 0 uTPUT * 0 uT 4 R f il »100 
®FFRR HR { TE 02 

l sc: T iwasr * 1 * 1 * 0 

LPRT MESS 04 .I 
EOU HR I T P 26 

e ject WR,Tf01 


m 

0460 
04 TO 

S 4R0 
490 
‘500 


? v 

0460 

0570 

S?"8 

OV 

0600 

0610 

Slit 

0640 

0650 

c 

0660 

OV 

c 

0670 

0690 

S?1S 

DY 

0730 

0740 

0750 

0760 

0770 

07 R 0 

0790 

0600 

OY 

0610 

0820 

c 

m 

•A 

•CE 

0650 

0880 

0690 

8»?o 

0930 

0940 

0950 



09/17/70 


AUTOFLOW CHART SET 


SAMPLE ASSEMBLY PROGRAM 


PAGE OS 


CHART TITLE 

3-70 


•VERIFY INVENTORY SYSTEM UPDATES' 


/ WAITE 


MVC * 

OUTNAMEf IPNAME 

MVC 

OUTCODE. IPCODE 


RANGE TF ST PRODUCT 
CODE 

CHAR | A - I 

CHAR ? - A NUMERIC 

CHAR S 0 -5 

CHAR 0-7 NUMERIC 

CHAR 9 . ALPHA 


0580 )■ 


16 


• PRODUCT • NO 

• TYPE SUBFIELO 

• A - I 7 • A 


YES 


WRITE |0 


17 


•PRODUCT* 

• NUMBER 

SUBFIELD 

• NUNERICT 


18. 


suifft'fiV-* 

• 5 7 • 


WRITE 33 


yes 

• os • 

WRlfiii 

19 


• PLANT I • NO 

*.s«aiw .— 


08201* 20 


RESEARCH •- 
* 0 1 V IS ION • 

* • 

9 9 

| YES 


WRITE 20 


—OS .16* — >• 

1 


WRITEOl^ * 24 


YES 

• 

• 

VRITEOJ • 

9 

9 

NO 

• 

• 

• 

1 0940) 

25 

/ / 
/ l PRT 1 

/lNABEAPft.t.120 / 

/ / 

( 0950) 

26 

1 i_ SET IPERRPR | 

1 ,1 


WR1TE02 "1 

27 


/ / 
/LPRT MESSOS.l / 

/ / 


• 1.09. 

... MAIN 


71 


• • VPS 

* IFERR INERROR 


( 09001 

/ 


ineaaM 


/ WRITE / 
/PECBtSF. OUTPUT*/ 

/ OUT AREA* 100 / 

* / 


f 0910)1 IS 

• PAUsi ♦ 


CHECK DECS 

I 


• 1.09* 


• main 




05/27/70 
PL /I MODULE 
CARD NO 


I NPUT II ST I Nfi 

It I ST 1 * NAMSQ) 


9 

li 


I! 

fS 

TO 

8 

55 

56 
37 
10 
39 


44 

45 

46 

47 
40 


11 

34 

33 

IS 

50 

39 

60 


64 

63 

» 

60 

69 

I 

77 

w 

if 

II 
« 
2$ 


93 

?* 


• ••• 


AUTOFtON CHART SET 


CONTENTS 


SAMPLE P|/| PROGRAM 


SUR KiSSSti!'”-"-* 0 ' 

OECIABF *"» ! N* | IF fitf input Bur t [" 'J *[ nvI NT 

I «f niu-l SYSOill. JTI II r t TBI I • 1 ' P "T 

iv?v;. 7 v 5 ^^ eo wouf -"“ en»i«on«e..t 

«««««« fnv.bonncnt 

"^"f-rsKitUsSiisxrk*; ,; i , , s;s:;?. stouf,iT, “- 

DECLARE '* f * Tf “ N4L DECLARATIONS*/ 


GFTMAIN1 

GETINSt 

CETCHG: 
NERGO t 

NE0GII 


NFRGIAi 

**|RG?I 


UnfBUO.SKIBl BMtJI.BBgNU^JlItg^OtCMUIJ.OIt FHTE.NM.I 


Otd.Bt " 

t*»»NT fllMBI, 

F? BEO^Of c 2 fSi*: ^ nun yFitannu.,. fount.*, hunt 

/•SliuCTUBF OECi»«»Tinsj«/ 



OFClABf 

aAB9AiN,lA0INS.t.ABCHGI LABEL! 
ON ENDFTLFIMAINFILEI 

CLOSE FriEfNAINFlLEIt 
CLOSE FILEIINSFILf ) 1 
CLOSE F Jl | ( CHGF ILF I | • 

CL^se FlLFlMRr.Fn El * 

D! SPLAY MEND OF MERGE* 1 1 


FIXFO DEC JMAUF.OI, 

fikfd decNaliiIoi 

SfSIS WKXfWii. 

Char iiit 
Cham 6| , 

Chari to 1 1 

FIXED PEC tNAL I ? » 01 • 
fixed 9FCl-ALIl*0>, 

fUeo sic tsi; *}?o » ! *" T • ° o ‘»«''’ooo» •« . 

ciis?2?; t,,,n ' 2 - 0 '* 

CHAP ( 101 * 

CHARIlOll 

FIX FO 0ECfNALl2t0l« 

FIXED O^C 1MAL (?!oi . 

CHAl?5?! NA, ' r,8, ° > »**» T| All Milll HI «l||, 

CMARI2I , 

CHA«(lts 

CHAR 15011 

/• LABEL VARIABLES*/ 


£}u §??!*_ 


il/ ur nt 'IX 
/• FXTFTNAt. MOCERU.CS •/ 


C»ll FflBNBTi 
C«IL "FLEBSEl 

FNOl V ’ 

OH FNDFIl.FI INSFItfl 

If oo'* 5 ' S,T * , ° 0000000 ' 1 ' then 

jj*a*r tts&'T^Bsau. 

RS:W : 81 

^?,c S fo T fND .° F . F *‘-E FLAG*/ 

INS.S9T B Mlllllll'fit 
INS.CNT - 01 
INS'NU* • 01 
INS. AFC » • *| 

INS.OST • • • | 

END* ' 

ON ENDFIIFICHGFILE) 

BEGIN; 

If 0 CHG.TVP • *11111 111 *N THEN 
DISPLAY C 'NO CHANGES * I X 
ENDS* 1 * 6 “ 0EPUC 1 •00100000*0* 
lP f9fSy C . c * 00010000 * 3 I ■*. 0 t 

r.o TO f«iti 0100000,m — 0 ™ c * 

ELSE ' 
oox 

chg.SII - o: 

CMG.NUN b Qx 

a g!® 1 ! - Miiiiui ** •' 

^HG.OST.* 

fNO* 

1FP0NT - DEBUG t 
ONN'JH m REGNUM* 1 1 
MABNU** » ONNU*UI| 

OClNUN • MAPNUNPll 

EbbnbVn *: 0 GATINS* 

LARINS ■ r, e TCHG« 

LAPCHG ■ NERKOI 

K*,. 

, '!r‘W;5%v.’fi o } , ?3':- ,me * «o «» “f’c?. 

pJCNT . »Jnt ♦ i ! 

, w ,.i'Vnt';* , n - , ' j " “ • 

CNT . XBIN.CNTt 

^ro* , fo C Ne.cf,J* ,N ' c ’' 1 

hni 

cm »utinsi 

FnS? ’■ ■ f,S " 

•* * THFN 

« f 0 “JlN.ONF | THEN 
PNUM « MAIN.NUNl 
FN?? T ° " wi ‘' 


F ILF I NROF| LF 1 1 


3-71 



05/2 T/TO 


|K»UT IMM*i 0 


SAMPLE *1/1 Mnr*A« 


AUTOFtOw CMA9? Sf? - 


13-72 


65 

65 

a 

i! 

75 

75 

;* 

« 
80 
5 1 
*2 
55 
85 

85 

86 

87 

88 
85 
90 

;i 

95 

95 

95 


181 

205 

?05 

205 

206 

207 

208 
'209 
210 

111 

w 

12 

i? 


27 

8 

HI 

; n 

i 


?45 

265 

266 
?6T 
248 
269 

H 

256 

255 

Ur 

25 • 


USE 

npj 

*NU** • ONN'jNj 
cp n 9CP51 i 
FNOt 

flSF 

00 » 

9*819 • F0SMNt)*j 

r.n to *r*oi t 
hsf'”* 

OOl 

snjm . oriwjm 

cp tn Ntkftj i 


*•*8011 
F * 1 7 | 
••IT** AIN I 
••AINOt 


CHI put** a i n i 

?{f.,iir ,,cWri 


esnCfOMAF o e C'J9StVF| 

OrrtAPF IA«0**41N LAHEl INITIAL (»>*A]NXn 


IF ®MJ9 
pp; 

01 $»L AY 


0 THfN 

** A 1 N 8 NU** 


•«* £ UFfoPINTf 01 F 0 1 T f '**AIN.TXT-*,**AIN 
ICpLIINN U 0 I , A 171 , X( 5 I . A( 10| | ; 

JUT 


• IFD9HT I *00100000*6 


P**A!N2t 

PMAlNSj 


P** A t NX 2 I 
P8AJNK5 J 
P9AINX6X 


IFPRNT 
FNO; 

9A1N.V1J** ■ »N'I M ; 

\\ :J!J:^c T : '* ,0 

IF 9»|N.T£tT • • THTN 

JAfN.n^T - MAIN, TXT ; 

f ISF: 1 

KPGM'JC • t*AfN: 

““IT* 'UflM’CFll? » F8PI* |99C8gF|: 

0? TO lA«o«A|N; 1 ’ * 

If XW.itr: ip 0 ? 0 ? 000 ** r »<? *o p***!^* 

mainIosti"-.. •«» ‘r. 

MAIN.^TI — *.• t 

C r>n? L " * Su9 * Tft,M *l***OT T 2***7l Then 

m9G*uf • CMC: 

LAPP MG > PM AI N? t 
. GC TP CETCHG; 

FNP| 

EL<f 

G^ TO PMAIN2J 
CNr,,NU** ■ ONUM; 

MRGBUC • CMC; 

iliciG F I L Sir?5f. ,l - E » ****»>*» 

CO TO G p TC**G< 

L APP"A t N ■ PMAINX2I 
OP WMHC ins.cnt ST»* 

t!u iutS&r* S,T t,,tM cn ” 


r 6L L w . , ... 

IF ]NS. f NT • ST T TMfN 00 TP »»4INX5| 


PUT INS i 

PMi|NK|»‘ 


l ABD**A IN 
PMIJ8N: 
f NO PUT **A |N| 

PllTINSl P8PfF0UP»« 

FUIINMI I c 9NU** • 0 TM«N 
Oil 

OISPIAV 1*1 N$f 8 T | ON BNU*» - 0* I t 
p uf Ml€|P?»NTE9l * PI T ( * | NS, T XT 
A 1 01* A (9 | ,*( 51 ,AI10? >1 

PUT F lie | P^tNTf 51 Sk|P(2|; 

1FPBNT . t r PPNT | *O0lOd000'«| 


?Sfl£: \%:M\ 


- v ■ 

INS. NU** • 8NUM*. 

Ku:u t i l J„}r5?fi lf ’ " r “ 

cn Tn t.ftinm 

|F INS.1FC ■ 'C • TM5N 

op: 

INS. AFf • SAVMt 

TNS.CNT . SAVC2: 

f.r WKSMtt ’ c ’ s nuIDUT *' 
eisF 01 

IF INS.FFC • *S • IMF, 

00s 

W*?linPaf{l?Ii EDIT IMNS.TXT •••INS. TXT) 

..t c rVWU9Ai**°»*J r *5i,AtiolM 


FNO { 

• ISF 

Of Tll9*t! 

•NO PUTINS* 

fNT *»F*r.P| 


OUT F f IF I PR| n4 F 9 S5IPI2IS 


•••* 




O5/?T7?0 MOCCOU*H 

9TATf«tNT lANEl INDEX 

AtlinFlOW CHAAT sm - 

S*“Pl ? 

PI /I PPOGAAN 

PG.MX 

MANE 

PG.GX 

NAME 

PO.M 

NAME 

9.01 

.0N-UN1 T01 

1.10 

MFfiGl 

7.06 

PMAIN1 

9.11 

•ON-UNI T02 

l.li 

MF«G1* 

2.1* 

PMAIN2 

9.1* 

.ON-lWITOl 

1.21 

»»E»r,2 

2.17 

PMA1N1 

1.1* 

EXIT 

1.1? 

ME AG 1 

2.20 

PM* IK* 

1.1T 

CETCMC, 

9.01 

PMAINKI 

*. 01 

put i nj 

1.1* 

GETINS 

1.06 

PM* IS <2 

*.01 

PUTJNM 

1.11 

GET MAIN 

1.07 

PM*|NX1 

*.0« 

PUTINS2 

1.01 

«E AGE 

1.08 

PMAINX* 

*.12 

PUTIN*! 

1.20 

HF9G0 

2.01 

PM* I NO 

2.01 

PUT MAIN 


„ c « 3J-73 



05/JT/TO imf OF nUCNOStir.S 4UTOFIOW t N4»T U T 

LOCATION ntAf.NOSTIC 

\Er*74 Cabo io ba r.F/on* 

000000M S.OB UNOfTINFft - *SftaT« * I TFB NAL MFf*FNC? 

00000069 5.09 'INOFMNtn - • f^dnat • f x r f BN Al BFFEBrNCf 

OOOOOOTO 9,10 UNOfFINtn - *BflEA)B* fRTF»NAl BL 8 IBtNC? 


BACA 


I 



01/17/TO TOOK no C9VTNTS »NO *«Ott t* r Ki 0U7OHO w CH»«T J«» - {txeiF 

C1«0 10 »OS«/IO« Mir MM'OlCFS KOlliro 1«0U»NC« no. OHO MGC/«n«t 


3 - 7.5 


MU | 


nn wm.! n/i maciw 


cmut tin.* - taociou*! *e«ce 


00000002 

1.01 

Nt*ce 

00000116 

1.06 


00000117 

1.07 


000001 14 

1.08 


00000121 

1.1) 

GETN41N 

00000125 

1.14 

GET IN$ 

00000125 

1.16 


00000126 

1*17 

G2TCMG 

00000126 

1.14 


00000110 

1.20 

HUGO- 

00000146 

1.25 

4G7 

000001 94 

1.24 


00000155 

1.24 


00000157 

1.50 

"E6G1 

00000141 

1.51 

•10004 

00000164 

.1.52 

Nf SGI 

00000164 

1.52 

•10006 

00000171 

1.54 

EXIT 

00000166 

1.55 


00000161 

1.56 


00000156 

1.57 


00000144 

1.56 

ME6GM 

00000144 

1.58 

•10005 

CMA6T TITIC 

- MOCfOUBf TUTNAIN 1ECUTSI VE 

00000175 

2. 01 

6UTNAIN 

00000175 

2.01 

SNA! NO 

00000165 

2.06 

TNAIN1 

0000016) 

2.06 


00000140 

2.11 


0000014) 

2.12 

64AIN5 

00000200 

2.16 


00000141 

2.14 

T4AIN2 

00000205 

2.20 

TNAIN4 

00000204 

2. 22 


00000204 

2*25 


00000210 

5.01 

MAINU 

00000210 

5.01 


00000211 

5.05 


0000021) 

5.05 

.10007 

00000214 

5.06 

TNAINS2 

00000215 

5.07 

TNAINX9 

00000215 

5.07 


00000215 

5.07 

.10006 

00000214 

5.08 

TNAINX4 

00000217 

4.04 


0*46 T ?|Tl* 

- T10CEDU*E TUT INS 

00000221 

4.01 

TUT INS 

00000222 

4.01 

TUTINS1 

00000250 

4.06 


00000256 

4.04 


00000258 

4.04 

TUTINS2 

00000246 

4.12 

TUTINS5 

00000246 

4. 12 


00000244 

4.15 


00000256 

4.1? 


CHA6T TITLE 

- ON-UNIT ACTION SLOCKS 

00000061 

5.01 

• ON-UNI T01 

00000066 

5.04 

•10001 

00000064 

5.04 

•10002 

00000070 

5.10 

•10005 

00000075 

5.11 

•ON-UNIT02 

00000061 

5.15 


00000042 

5.16 

• ON- UN! 709 

00000098 

5.22 


00000105 

5.25 



7.01 
7. 02 
T.oi 


00000217 

4.09 

00000125 

1.14 

000 00201 

2.16 

00000126 

1.17 

00000145 

1.38 

00000110 

1.20 

00000111 

1.21 

00000115 

1.22 

888881?? 

l:« 

6.05 

00000146 

1.25 

6.04 

00000071 

5.10 

00000147 

1.24 

00000146 

1.25 

OOOOOU9 

1.26 

00000M7 

1.50 

4.04 


00000169 

1.32 


7.01 

00000175 

2.01 

00000165 

2.08 

00000164 

2.07 


7.01 

00000204 

2.23 

00000193 

2.12 


7.01 

00000194 

2.19 


T.04 


7.04 

00000214 

1.04 


4.04 


7.04 

00000216 

3.06 

00000211 

3.03 


4.09 

00000212 

3.04 


7.04 


00000141 

1.11 

00000243 

4.11 

0000022? 

4.01 

7.02 


7.02 

T.02 

00000236 

4.05 

T.02 

00000244 

4.12 


00000040 

t.oi 


4.0) 


4.01 


6.07 

00000074 

1.02 

000 00076 

3.12 

00000091 

1.03 

000000*3 

3.19 


000 000*9 5.22 


00000255 4. | A 

00000205 7. 7* 

T.OI 

00000142 1.51 

00000100 5.24 

00000144 1.10 

00000146 ' 2. 04 
T.OI 

00000144 2.14 


00000215 5.07 


00000046 6.7S 


T.05 

T.02 


00000147 1.54 


00000215 5.05 


0000014$ f.If 


4.05 


00000142 1.54 


00000144 2.14 


CHAM f|?lf - €611 fO TTQCC0UTES - C»0SS UTE6CNCE 



7ft.., flHF - 


macfounf *»c»gf 


aii’ofl'ik chaft set 


sample H/| mrvjM* 


*ACF 0| 


/ ooonnoo? / 


MfPGC 

000000*0 I 


M f.0N-UN|T011 
H ON 6 NOF lit 
H ttAlNMLFI 


( . ON -UN 1 T02 I 
ON f NOF Ilf 
< INSFILFI 




M I • ON-iJN IT 01 1 
M ON CNOFIlf 

h KHSMli) 


ooonom I o* 

• . — 

1FPBNT • DEBUG 


CNN'JN ■ RCGNUN ♦ 

1 


N«PNU« • ONNU" ♦ 

l 


DCL NU** • MA»NUM ♦ 


OOOOOI IP 

05 

» FOPMNUM.PCOUNTM ■ 1 
I OCLNUM 4 1 ] 

07. 03 > 

0000011* 

06 

I LA5NAIN 

GFTINS 1 

07.02 > 

00000117 

07 

1 LABINS • GETCHG [ 

07.01 > 

ooooona 

o; 

1 LABCHG 

MCRGO ) 

00000120 

0* 

/ 

/ .4?w,in* / 

00000120 

10 

/ / 
/ / 

/ OPFN FILE / 

/ I1NSF1LF) / 

/ / 

00000120 

11 

f 

t 

t OPFN 

J ICHGF 

7 

n\ E / 

/ 

00000170 

i? 


/ 0 P £N FILf / 

/ |N'a5FitFl / 


GFTNA1N 

oooooi? t I n 

t — — - 

t *F*0 FILE / 
/I NAINF HE | INTO/ 

/ "AIN / 

f / 


• T«OV 

LIBIA |N 


t 00000 12 7 t 
0* . 0* • — >• 


0 

1 

• 

--- 

0000OJ23 • |* 

| 


• • 

000001*6 • 77 

5 

• • 

• • 


• • • 

• • 

0 

* * |NS. SRI -» • 

• • m 

l 


• * 1 1 1 1 1 1 1 1 *F* 

• MAIN. AFC • 


00000 1 2* I 15 

f 7 

/ OFAO F U F / 
/I 1NSF llEl INTO / 

/ INS / 

/ / 


00000125 I 16 
* 7.02* 


/ 000Q0 1 ?6 / 
02. IP*— >• 

GETCMC 
I 


CMG.typ • 

•• uuiiii'B* 


0000012T 

/ 


1* 

”7 


/ RFAO FRE / 
/(CHGFHFI INTO / 

/ CMC / 


0000012* 1* 1* 
l T .01 t 


/ 00000170 / 
01.3**— >• 

NFRSO 

I 


• MAIN.SRT * — 

•'01011001 '*• 


• MAIN. ABC • *P 
• • • 
• • 

• t 


000001*7 • ?* 


• MAIN. AFC 


000001*3 • 25 

* • 

• • 

• • 

• .NMNjAFC 


000001*^ * 26 
• • 

• • 

• • • 

• MAIN.ONF | • — 


00000151 1 IT 

• 

I RNUN • NAIN.NU" I 


• •• 

N6RG1 


^ »CNT • NAIN.NU* « 


PNII* • OCNT 
CNT ■ MAIN.CNT 


01.27*— >JC 

*F«G1 

00000157 • 30 


INS.CNT -< • • 

» MAI.N.CNT ® 


0* . 0* > 

000001*1 I 71 


| Pf NT ■ *CNT * 1 


• ->• 

Nf«G 3 

06.0* >• 

^0000016® I 3| 

1 2 I CALL FUIMAIN N 
0 


00000170 ( 33 

/ 7 

/ 01 SPLAT / 

/ 1'CANCFL / 

/ Mf«Gf» / 


05.10*— >| 

t*|T 


OOOOOI 71 | 3* 

• ’f* 1 t”~~* 

•ETL*N 

I NO BROCFOURE NE«Cf 


00000166 I 35 

• - 

I 7NUM • OCLNUN J 


. 1.30. 
MfFGI 


>• 

00000161 I 


__ 36 

| RNUN ■*F03NNUN I 


0O00O156 | 3T 

• — • — 

I • ONNUM J 


• .1*30. 
*r*Gi 


06.0* — >• 

OOOOOI** | 3F 



u 


* 

CALL FIIT1NS H 

2 

0 

H 

N 

6 

1 

M 

1 


CALL *U7NA1N 


NFRG1 


NfRGij 


•XXXXX* 



037277T0 

CHAM TlUf - nN-UNLLACT|0»i.ALflC^S 


AUTOFLOM CHART S C 1 - SANPLF PI /I PROGRAM 


• 3-77 


7 00000061 7 


7 0000007S 7 


7 0000006? 7 


Ol.oi >• 


01. 0? >• 


01.03 — >• 


• ON- UN 1 T 0 1 


. ON - UN 1 T 0 2 


.ON-UNI T03 


• 


• 


• 


00000061 1 NOTE 

01 

OOOOOOTS | NOT F 

II 

000000*7 I NOTf 

16 

• •••••«•• 

• • 

• •••••••» 


* i •••»(• i 

• » 

• ON f NOP Ilf 

• 

• ON CNOFU f 

• 

• ON ENO*UC 


• INAlNFlLfl 

• 

• I1NSFUE) 

• 

• ICMGF U F| 


• REGIN 

• 

• • 

• RFGIN 

• 

• • 

• regin 

• • 


00000067 I 
/' 

/ “ / 
7 CLOSE FILE 7 
7 (HAINFILEI 7 


_o? 


00000063 

/ 


01 

7 


7 CLOSE FILE / 
t ! IINSFILE1 ^ 


00000066 
7 ~~ 


0 A 

"7 


f / 

7 CLOSE FILE 7 
7 ICMGF ILEI 7 


0000006 S 
7 


OS 

7 


7 CLOSE FILE 7 
7 fMKCFlLEl 7 


00000066 | 

06 

7 

/ 

7 

/ 

/ DISPLAY \ 

[•END 7 

7 06 Nf RGf ’ 

>1 7 

7 

7 


00000067 | note or 

• »•«••••••• 

• EXTERNAL • 

• PROCEDURES • 


06.03 >1 

0000006S ( OR 

• — — -• 


000000 


06.02 >| 

00000070 I 10 


i 


CALL RELEASE M 
H 
H 
N 


00000076 • 


00000076 


13 


7 7 

7 7 

7 01 SPLAY I * NO 7 
/ INSERTIONS* > 7 

7 7 


OEBUG « OE*UG | 
* C001 0000* R 


0000006 1 | IS 

ins 7 sTI~ 7 ~o 
I NS. ONF • 0 

• SET END 
HE FLAG 

1 NS* SR F ■ 
*11111111*6 

INS. CNF • 0 

00000066 I _ 

FnsTnuh- o' 

INS. AFC • * • 

INS.OST - 


• • 

• CHS. FTP • 

• *mmii*p» 


OOOOOORS 


20 


7 7 

7 7 

7 DISPLAY I *N0 7 

7 CHANGES* I 7 
7 7 




I OF RUG • OE°ur. | | 

I *00100000*6^ | 


• I DERUG t • - 

• *0001 0000* M • 

-• 0 


• 

• 

• 

• 


CHG. $12 • 0 

« 

— 


CMC.. NUN • 0 




7* RETAIN CM6.TYP 
• *11111111** *7 




CHG. CNF • 0 

0000009 A « 

» 23 


CMG.DSY - 

• 

• 



• 

• 


• C CTFPRNT €• • 1 

1 l 


• * 00100000* R> 
• — 0 


1 1 M 



I 1 CALL SORT H 

00000089 1 17 


1 1 s 

•;:extt:> 



END .ON-UNI T02 

00000100 


• 1.36. 

• • 
• • • 

EXIF 


00000106 I 26 
•* CMT 


FND .ON-UNI T01 


EXIT 

END • ON- UNI TO 1 




“3-78 


09 /IT/TO 

CHART TITtf - CALL CO MnC*DtfM$- C*"5* »EFf«?^Cf 


AtfTOHCN CHART SIT - SARRlf R t /| H%IAR 


>A« 0* 


OHTtr 


H FORM*? 

H CALICO »*0» 


9H 


N MlfAJP 

H CAUIO MO" 


i iI2222 hlL, 

IhIrt 

* 1 O 1 


H SORT 

H CALLED MO" 


i— :I222i o.oo 


h CAu*r*J»oR 


I :I;S l;jj I 


•fODOA 

.|:M09 





05/JT/TO 

.UlnflOu CM.,, SF , . „, PlE n/ , „ nc ,„ 

CH.,t Tiuc . t .„ H .ssi&MHCM r»n,s PCff.eMce 


3-79 


PAGf OT 


/ l ARCHG / 


01 .19 > I 

• 1 °A 

i SCA1AP | 

]_ At* ft I 

Sf T AT Tn GO TIJ*" 

1 .OH l.?0 

000001 1 8 Hfqr.O 

2.19 

00003200 P*AfN? 

?•?? 2.06 

00000208 Pmaisi 


t. IA8INS t 


01.1 A > ( 

I ?! 

f SCALAR I 

S*T Af TO G'' TO*"" 
1.07 1.17 

00300 1 1 T OA T r hG 
A. 08 4.09 

00000236 PUTINS? 

oooooIa 8 PuTliil 


/ LAR-AfN / 

01.18 >1 

I 

! SC»L»« I 

I «m v i *,cf I 

| s?t Tn nn'to'i 
I oooooi?* cfhis I 


/ 1_.BPM.IM I 
0J.1« >1 

j 0. 

l.BP? C vi*I.»(.f I 

l**vsr ?r tt3 5 “* 

00000210 PMA1NX? 

7.09 J.01 

00000217 PHA|NX| 



Sample *1/1 program 


PACK Oi 


at/71/10 
CHART 1ITIF 

* 3-80 


AHTOUO^ CHART S e T - 


0u p l ICATF OFf.LAPATION *•*» 


PPfKFDU»E MERGE 


ooonoo?3 

31 1 

OF 

MA IN 

00000023 

onf 

OF 

MAIN 

00000073 

SAT 

OF 

PAIN 

00000073 

CNT 

OF 

MAIN 

00000023 

NUM 

OF 

MAIN 

00000023 

AFC 

OF 

MAIN 

00000023 

OST 

OF 

MAIN 

00000023 

T*T 

OF 

MAIN 

00000035 

512 

OF 

INS 

00000035 

on* 

OF 

INS 

00000035 

SRI 

OF 

INS 

00000035 

CNT 

OF 

INS 

00000035 

NUN 

OF 

INS 

00900035 

AFC 

OF 

INS 

0900 0015 

OST 

OF 

INS 

00000035 

TAT 

OF 

INS 

00000045 

SI 2 

OF 

CMC 

00000045 

NU" 

OF 

CMG 

00000043 

OST 

OF 

CMC. 


PROCEDURE PUT-AIN 


END PROCEDURE 
PROCEDURE PtlT INS 


ENO PROCEOUM 


ENO PROCEDURE 



05?2??T0 


AUTOFtn* CM**T SET - SIMPLE »L / 1 P*r>G®A* 


CMA»t flfLf - O* Cl ACTION STATFNfNTS 


PAGE 04 

• 3-81 


00000004 

00000006 

00000004 

00000010 

00000012 

OCOOOOIB 
OOOOOOI B 
00000023 
00000026 
00000031 
00000033 

ooooooi* 

00000043 

00000043 

00000049 

00000034 

00000037 

000001T4 


f>f Cl A** € MMNM16 f'lir INPUT pjfcfp«o f nv t opNNF NT |N‘0!'l* 1 SVS0Q3 , 23 1 l I * |TMI 

0FC149T INVIir P 1 1 c INPUT RuFFrPFO Stouts fl»l * NV I B rN**ENT t»ECIU* ISrS00 3, 2Mll f (U?lt 

neci44f CHr,rm ni» input S c 0'JrNT|4t fnv|»"n*tnt UFOlu* ISYSnnj, 23111 * 1 1171) 

Of Cl *° F Mdr.flLC fllf niJfPUT 3f 0U r NT1 £1 ENVUON-FNT I-E0IU4 I STSO? 1 , 2400 1 F 11*80.4411 

0FC140C oojNTfP FUC PVIT PUT ®B|NT ST9F.AH T ».'V I OON-f NT futnfij- ( SYSlST , |407 1 F U3CII 
0CC14®6 ( I OFBUn.SKfP) PIT (3l,®rr.Nit" rixCO O f CI**Al 12.011 CXTrPNAL 

DECLINE | F P*N7 B|T 1 A 1 , ( 4 EC.CNT , PNNUN . MI PNO w . NM", F 0 'mN'J». 4C0UNT M , 4W< IMI F I if p pf C 1**1 (2,01 
OfCLAHt l NAIN.2 31? * I * f n P*c 1**1 M.01.2 UNF MKFC CECt*Al 11.01.2 S®T F| X F') BINA9V 14,01. 

2 CNT n*«p n*CI«4l 17,01,2 NI|« M«r> r?Cl*H 12,01,2 4FC CHIP 121,2 0ST,3 OSM CHI* (11. 

3 0ST9 (MAI (91,2 TUT fHA® 1101 

reciiM l ins,? si? m*»t ofcinal 12.01,? on» fufo peci-al 11,01,2 s*t mm oinibv m, 

01 INITIII < •C000')000»31.2 CNT F|x(0 O r Cl*Al 12.01,2 NJ- FIRF-n o e Cl*»H 12,01,2 AFC (NAB (21, 

2 PIT C*»P 1101,2 TXT C«IP 1101 

OETIATE 1 f MO, 2 SI? P I *f P OfCIPll 12.01,2 AMU MXfO OECfNAL (2,01,2 TV® F I X®D M4IRV (A, 

01 INITIAL ( *11111111*31 ,2 Fill CMA® (51.2 0ST,5 Old CMAA 121, J (HJN*V (ftlt*(B| 

0FC14RE MBCRtJF CHIB (301 

DECLINE 11 AB4AIN, LARINS, IABCM01 LABEL 

OEClAPf IA4PN41N LABEL INITIAL (P*AlNXll 
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05/27/70 

CHART TITLE - QFT/PUT, FORMA.T. ST4Tf«XiH,< 


AUTOFLOW CHART SET - SAMPLE PL/I PROGRAM 


PAGE 


00000009 LIST 
00000010 TOTAL 
00000178 
00000180 
00000225 
00000227 
00000249 
00000251 


FORMAT ( COLUMN (781, A, X (81, P (51, P ‘YVYSX 

FORMAT (SKIP (21, COLUMN 1 231 • A, COLUMN (411, P COLUMN 1611 
•GFT/PUT 001 PUT FILE (PRINTERI EDIT < • MAIN. TXT»* ,MA IN. TXT 
PUT FILE (PRINTERI SKIP (2 1 

PUT PILE (PRINTERI EOIT I ‘INS. TXT • •.INS.TXTI 
PUT file (PRINTERI SKIP (2) 

PUT FILE (PRINTERI EDIT ( • INS, TXT ••.INS.TXTI 
PUT FILE (PRINTER SKIP (2| 


.GET/ PUT 002 
.GET/PUT 003 
.GET/PUT 004 
.GET/PUT 005 
.GET/PUT 006 


1 (COLUMN (101. A (9 | ,X (51, A (1011 
(COLUMN (101,4 (9|, X 151, A (1011 
(COLUMN (101,4 (91, X (51, A 11011 



q5/2?/to input listing 


4MTQH0W CHART set - Sample SA-Plf CHAR? PL/I PACK IMPS 


CHAAT/PL1 MODULE ILIST2I 

CARO NO •••• CONTENTS •••• 

l TH»_HATCMINC_OP,POVS_ANO_GfRLS.POR_A.Hir.H_SCHOnL.OANCE I PROCEDURE! 

I STARTl 

1 /•! R f AO FIRST 50V ANO FUST G IRt • / 

A /RT Gl Rt -COUNTER IS A COUNTER USFO TO CONTROL THE LOOPING 

5 THRU THE GIRLS INPUT FILE •/ 

6 PRIMARY! 

T /ROY tSECONDAPtl PRIMARY NATCH EQUAL? •/ 

/•! « PUNCH PUNCH OATE-NANE CARO •/ 

9 AEAO.A.eOVt 

10 /• I RFAP ANOTHER 80V •/ 

11 /»DY IPRINARVI EOF? •/ 

12 /•! CLOSE ALL FILES *2 

IS /*H END OF JOB. •/ 

14 SECONDARY : 

15 /«P ADO 1 TO GIRL-COUNTER •/ 

16 /*0N I PR EP AR E I ENTIRE GIRLS FILE SEARCHED? •/ 

1? XEAO.GIftllX 

18 READ ANOTHER GIRL •/ 

19 /»0N lEOF.GISLSI EOF? •/ 

20 /RR !PR|*ARV| GO TO PRINARV HATCHING PROCEDURE • / 

21 PREPARFr 

22 /*T PREPARE FOR SECONDARY HATCHING PROCEDURE • / 

2 3 /«P CLEAR GIRL-COUNTER •/ 

24 REAO.GIRL?* 

25 /• I READ ANOTHER GIRL •/ 

26 /RON I60F.GIRLSI EOF? • / 

2? /RON I PUNCH I SECONDARY HATCH EOUAl? •/ 

28 /RP A 00 1 TO GIRL-COUNTER ' R/ 

?9 /RDV «READ_GIRL?I ENTIRE GIRLS ERE SEARCHED? - •/ 

30 /• I PRINT NO-HATCH MESSAGE 'SORRY FELLA* • / 

11 /*8 IREA0.A.8OY1 •/ 

32 EOF.GIRLS: 

3> /* I CLOSE GIRLS TAPE FILE •/ 

34 /• I OPFN GIRLS TAPE FILE •/ 

15 /RD <PR!M.SEC-READ_GIR12I WHICH HATCHING PROCEDURE? •/ 

36 /*B IREAD_GIRLll PRIMARY • / 

3? ENO THE_HATCHING_nF_BOTS_AND_C.|PLS_FOR_A_MIGH.5CHOOL_OANCE« 


CS-83 



03/27/70 

rS-a r ,0 


tfpLC of cnuma-ixn rfafri^es 
PAf.F/30* 


AUTOFlQW CHART $M - SAMPLE 
REFfMNCfS 1 SOURCE SEOUFNf.F sn. and FfcGfSftORI 


CHA9T/PL1 "OOUIE SAMPLE CHART Pl/| FACILITIES 


PAGE 


1 


CHART TITLE 

- PAOCEOURC THE_MATCHING_CP_OnYS_ 

AND_r.lRlS_FO#_A_ 

HIGH^SCHnni.OANCE 


00000002 

1.01 

START 





00000006 

1.02 

PRIMARY 

OOOOUOU 

1.05 

00000020 

1.11 

CGwuCGu* 

1.03 

PUNCH 

00000027 

1.13 



00000009 

1.06 

R EAO_A_ROY 

00000031 

1.1* 



00000016 

1.0* 

SECONDARY 

00000006 

1.02 



00000017 

1.10 

READ.GIPL1 

000 000 3 6 

1.21 



00000026 

1.13 

REAO.GI9L2 

00000029 

. 1.17 

00000033 

1.21 

00000032 

1.19 

E0F.G1RLS 

00000019 

1 • 1 1 

00000026 

1.16 



CHART TITIF * PtrCCDU*»F TNf _MA TC H| NG_OF_ROVS_ AND.G I RlS„f IP.A^lGM^SCM'-'Ol.. DANCE 


AUTOFLOw CHART SC T - SAMPLE «AmplF CHART PL / 1 ?Ari|fTfF^ PAGF 0| 

TP_A_H|r,H_SCH».»OL..DANCf 3-85 


/ oooooos? / 


/•RAO f ! *»S T Rny / 

/AND rr«ST r.IRL / 


GUI -COUNTER IS A 
COUNTER USED TO 
CONTROL >h' LOOPING 
THOU *Hf GIRLS INPUT 
Ml E 


PPfMARV • 02 


PRIMARY MATCH •- 
• TOUAL ? • 


/PUNCH DATC-NAMp/ 
/ CARD / 

/ / 


SECONDARY | 


00000016 • 09 


• ENTIRE • YFS I 

GIRLS FILE • * 

• SEARCHED? • 


PREPARE FOR SECONDARY 
MATCHING PROCEDURE 


CLEAR I 

GIRl-CnuNTf# | 


01 . !?•--> <- 

RFAD _ G 10 l ?| 


/ READ ANOTHER / 
/ G1RI / 

/ / 


00000026 • 1* 


res • • 

• EOF? • 


END PROCEDURE 
TmF mat Chin.'. OF ROY$ 
4ND~G 1 *1 S f «J A MICH 

" SCHl ? C . OA«Cf 


01. IB >} 

R E Af)_ A_80Y i 06 


/ RFAD ANOTHER / 
/ SOY / 

/ / 


01.21 > 

RfAD.CIRllJ 10 

/ r 7 

/ / 

/ READ ANOTHER / 

/ GIRL / 

/ / 


• SECONDARY • YES 
• MATCH EQUAL? 


00000019 • 11 


| ADD 1 TO 

I GIRL-COUNTER 


00000012 i 06 

r 7 

/ /CLOSE All FILES/ 

/ / 


GO TO PRIMARY MATCHING 
PROCEDURE 


• ENTIRE • NO I 

• GIRLS FILE — ♦ 

• SEARCHED? • A 


0000001 1 I OT 
* HALT • 

END OF JOB. 


/PRINT NO-MATCH / 
/MESSAGE 'SORRY / 

/ FELLA ' / 


- 01 . 11 *— >• 

EOF_Gl RLS I 19 

/ / 
/ / 

/ CLOSE GIRLS / 

/ TAPF FILE / 

/ / 


000000 U I 20 

/' 7 

/ „ / 

/OPEN GIRLS TAPF/ 

/ file / 

/ / 


• MATCHING 
•PROCEDURE? • 


1 . 10 . 

... Ieao.cmli 


PRIMARY 



* 3-86 


COMCHART 

COMPRESS 


GENERAL 

COMCHART accepts source programs written in assembly language and 
COBOL. The package can also take a designer's specifications and produce 
flowcharts, using a special Design Language that involves a coding 
technique similar to that of most assembly languages. A listing of the 
source deck plus a cross-reference listing of all element and procedure 
names are also generated, but can be suppressed at the user's option. 

The package runs on a IBM 360 (OS) with a minimum of 65K bytes 
of main core storage and 4 sequential files on any devices, IBM 360 
(DOS) with a minimum of 65K bytes of core storage and 4 sequential work 
files (a 2311, a 2314, or 4 tapes), RCA Spectra 70 (TDOS) with a min- 
imum of 65K bytes of main storage and 4 tapes or 1 disc. 

The package consists of 3 flowcharter subsystems. The source language 
is a combination of assembly language and Cobol . 

PACKAGE OUTPUT 

Flowcharts - Detail er flowchart where each line of source 

code is represented by a symbol. Each flowchart 
bears a page number, a user-furnished identification 
of the program, and the name of the user's organizatior 
Element Index - (COBOL only) an alphabetical cross-reference 

index of element names is given. Each index contains, 
each name in the program, its type (e.g. data level, 
paragraph name, file name), and the name of the 
procedure which references it. 
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Procedure Skeleton - This lists each procedure name in the procedure 
division, together with all procedures referenced 
by and refering to that procedure. 

Source Deck Listing - An 80/80 list of the soruce deck is printed. 

Diagnostics - This report follows the deck listing for a 

Design Language program, and given a narrative 
description of errors in the Design Language 
definition. 



3-88 


SAMPLE TO DEMONSTRATE COMCHART FOR ASSEMBLY 


1 

sample 

START 

0 

2 

RO 

IQU 

0 

3 

R1 

EQU 

1 

4 

R2 

EQU 

2 

5 

R3 

EQU 

3 

6 

R4 

EQU 

4 

7 

R5 

EQU 

5 

8 

R6 

EQU 

6 

9 

R7 

EQU 

7 

10 

R8 

eQU 

8 

11 

R9 

EQU 

9 

12 

RIO 

EQU 

10 

13 

Rll 

EQU 

11 

14 

R12 

EQU 

12 

15 

R13 

EQU 

13 

16 

R14 

EQU 

14 

17 

R15 

EQU 

15 

18 

* 



19 

* 


REGISTER USAGE 

20 

* 


R.O/ 1/2/ 13/ 14/15— AS DEFJNeO BY IBM. 

21 



R. 10/11— OPEN AODRESSING. 

22 

• 


R.12--SELECTIVE ADDRESSING. 

23 

* 


R. 3/ 4/ 5/ 6/ 7/ 8/9 — SPAN-OF-ATTENTION. 

24 

* 



25 

FIRST 

STM 

R 1 4/ R 12/ 12 ( R 13 ) 

26 


BAIR 

RIO/ 0 SET UP OPEN REGS. 

27 


USING 

♦/R10/R11 

28 


LA 

R3/4095 

29 


LA 

R11/KR10/R3) 

30 


CNOP 

2/4 

31 


MVC 

8(4,R13)/-A(**14> 

32 


ST 

R13/**12 

33 


BAL 

R13/FG0 SET UP SAVE AREA. 

34 


OS 

18F 

35 

FCrj 

EQU 

* 

36 


EJECT 


37 

* 



38 

* 


READ IN THE SELECTOR TABLE. 

39 

* 



40 


OPEN 

FILES 

41 

FA 

GET 

FILEB/RECB 

42 


L 

R3/TABT0P PICK UP ADR. 0F PREVIOUS ENTRY 

43 


LA 

R3/7IR3) ADD FOR fHJS ADR. 

44 


C 

R3/TAB6N0 TABLE EXHAUSTED ? 

45 


BNl 

FB 

46 


ST 

R3/TA8T0P IF NOT/ STORE CURRENT ENTRY ADR. 

47 


MVC 

0 ( 7/ R3 ) / RECB MOVE IN THE ENTRY. 

48 


B 

FA 

49 

* 



50 

* 


TOO MANY SELECTORS. 

51 

* 




OOOIO 

00015 

00020 

00025 

00030 

00035 

00040 

00045 

00050 

00055 

00060 

00065 

00070 

00075 

00080 

00085 

00090 

00105 

00110 

00115 

00120 

00125 

00130 

00135 

00140 

00143 

00145 

00150 

00155 

00160 

00165 

00168 

00170 

00175 

00180 

00185 

00205 

00210 

00215 

00230 

00235 

00245 

00250 

00255 

00260 

00270 

00280 

00285 

00290 

00295 



'» 5 I U 




TO DEhONSTRATE CQHCHART roi ASIERIIV 


CU|t/| 


tF -89 


••••• 

••• 

• 

i 

i 

OOl 111 

/ I*"Rl.S / 

I 

I 

♦.—001 111 

• • 

• • 

* • 

* START 0 I 

• • 

• • 

• • 

♦ ' 

' I 
t 

003 (lt| 
RECISrfR usage 
I 
I 

00 « (lot 

-*S Oct incp or 

im. 

I 

c 

003 (111 

R.lO#ll— ORIN 

*00*ESSI"G. 

I 

I 

. 006 (12) 
*.11— SELECTIVE 
AOOAESSING. 

I 

OOT 1131 
*•3*445*6# 

SRan-OF- 

ATTENTIO". 

I 

I 

001 (231 

• RUST '/ 

l 

I 

—009 (23 }» 

|«T3 *14**12, | 

I 121*131 | 

♦ 

I 

I 

♦—010 (20) 

• • 

• • 

• BALK • 

• *10/0 • • .SET UP • 

• OMK (ECS. • 

• 4 

• 4 

♦ 

I 

I 

♦—“—Oil — (28)4 
HA 83/40*5 J 

). 1 

l nil, I 

t 1(810/(3) | 

j 1 

l *VC 8(4/ I 

r U5 )a-a(**u) j 

j ................. | 

1ST *13, ♦♦UI 

♦ — * 

I 

I 

♦—012— 111) 

• 4 

• 4 

• IAL • 

• *U,?CO • • •$! T 4 

• UP SAVC 4 

• IMA, 4 
PG AS BO* 013 

♦ * 

I 

I 

Oil (35) 

/ PGO - / 

1 

I 

4 •• • CO n 4444 

*G AS 80* 014 


COMPANY NANI 



*»SI 

<3-90 


iMPH 


TO DEMONSTRATE C0«CMART FO* AIKNlV 


C H A I T / A 


A I 


MM COKI P10N mm 

pc a box oil 
t 
I 

014 (II) 
MAO IN Th| 
SELECTOR TABLE, 
t 
t 

MM eOMl MON MM 


4, 
' « 

■a SOX CIS 


t 


1 


.—Oil— (40) 

* 

4 

4 

4 

4 

4 

• 0*1. *U|» • 

4 

4 

4 

* 

* 

4 

♦ 



i 


i 


016 (41) 

/ 

PA / 


1 

• 44*4 

COM FROM 4*44 

PC 

IS IOX oil 


I 


I 

4 

— 017— (41) 

4 

4 

* 

4 

4 

4 

4 get 

*ats, • 

* 

RECB • 

* 

4 

• 

4 

4 



I 


I 

4 • •-• 

—Oil— (42)4 

1 L 

R), I 

ITA6T3P ...PICK UPI 

I 

ADR. OF I 

I PREVIOUS ENTRY. I 

1 LA 



ADP FOR THIS 1 

I 

&0R. I 

i : 

i 


I 1 ABEND ...TABLE I 
I EXHAUSTED T I 


PC AR BOX 01? 


♦ -- 

I 

I 

.019. (45) 

.• 

4. 

.4 

4. 

,4 




4. 

.» m*t 

4, 

t 4 


, 4 


1, .4 


I LESS . 
t 

1 ST 

«), I 

ITABTqP 

...IF NOT. 1 

I STORE current I 

I ENTRY AOR. I 

imv: 

0C7#R)),I 

I RECB 

...MOVE IN I 

i The 

ENTRY. I 

I B 

FA I 


I 


I 

• 44*4 

CO TO 444* 


021 (SOI 
TOO MANY 
SELECTORS. 

I 

I 

021 (ft) 

/ M / 

I 

I 

-4*** CONE FROM ***# 
PC AB BOX Oil 

I 

♦•—024— (52) 

• 4 

4 PUT 4 

4 NSC 4 

4 . . .WRITE NESSAC 4 
4 E TO OPMAT 4 
4 OR. 4 

4 4 

♦- — 

I 

I 

021 dll 

/" PC / 

I 

1 

♦ ... 024— <51W 

1 GET PILES, I 
I RECB ...BYPASS I 
I REMAINING | 

I SELECTORS. I 

♦--“““--“---“-“““-4 

I 

I 

>•4444 CONE FROM 444* 

PC AB BOX oil 
I 
l 

♦—027 (11 1 


G|T 4 

4 4 

4 4 


I 

I 

♦— 02B— (14)4 

IB FC ! 

♦————♦ 
I 
l 

•4444 CO TO *444 

PC AB BOX 02? 


010 (III 
CONTROL IS 

TRANSFERRED HERE 
FOR EOF ON 
Pill*. 

I 

I 

011 (SB) 


PI 


I 

I 

♦—OH— (IB) 

4 4 

4 4 

* * 

• CLOSE PILE! • 

4 4 

4 4 


I 

I 

Oil UO) 
COPY SELECTIVELY. 
I 
I 

0)4 (12) 


/ SECOND / 

* *t 
I 

♦ 0)1— (62) 


4 OPEN FILER, * 
4 Fine 4 


I 

I 

0)6 


EACH 


( 6 )) 

/ 


444* CONE FROM 4444——— 
PC AB BOX 040 
I 
I 

.041, (70) 

• • •. 

.• •. 

.• •. 

♦ BE EACH 4— 

4. .4 EQUAL 

4. .4 

•. .• 

4 . .4 

1 UNEQ 

♦—042— *?l) 

4 4 

* PUT 4 

4 PUEC#RECC 4 

4 ...IF SO, WRITE 4 
4 OUTPUT. 4 


I 

I 

4— 04)— 172)4 
I B EACH I 

♦—-—*—♦ 

I 

I 

4444 CO TO 4444* 
PC AB BOX 017 


I 

I 

-4444 COME PRON 4444 
PC AB BOX 041 
PC AB BOX 044 
I 
! 

♦—017— (6)) 


• GET FILER, 4 

4 RICA 4 


I 

1 

-0)6-— < 6* I ♦ 

I MVC C YE AR > ! 

| AYtAft ...FORMAT | 
1 I HE OUTPUT | 
I MFCDPO NOW I 

I - I 

I NVC I 

I CNnNTM( 4 ) , ANONYM l 

I ...Tfl SIMPLIFY | 

IDATC-CONPARISMU. 1 

l MVC CNAME# 1 

I anahf I 

I- I 

I. I RU, t 

I ■AIQUAl) ...US* I 

I qualifier I 

I SUBApnT INI . 1 

.... 

I 

I 

* — 0)6— *64) 


RALR * 1 . 
All 


1 

I 

040-““ (69)4 
I CP QSw, I 

I -P'O’ ...SEE IF I 
I RECORD MAS I 

I selected. 1 

♦ 

I 

1 

•4*44 CO To 4444 




SAMP 

1. 

E TO DEMONSTRATE COMCHART FOR COBOL 


C H 

ART/ 

1 

000000 

IDENTIFICATION DIVISION. 



SAMPLE 

2 

000100 

PROGRAM-ID, 'SAMPLE*. 



SAMPLE 

3 

000250 

ENVIRONMENT DIVISION. 



sample 

4 

000300 

INPUT-OUTPUT SECTION. 



SAMPLE 

5 

000350 

FILE-CONTROL. 



sample 

6 

000450 


SELECT FILE-A ASSIGN ' F I LE A ' UTILITY, 



SAMPLE 

7 

000500 


SELECT FILE-B ASSIGN 'FILES' UTILITY, 



SAMPLE 

e 

000550 


SELECT FILE-C ASSIGN 'FREC* UTILITY, 



SAMPLE 

9 

000700 

data division. 



SAMPLE 

10 

000750 

FILE SECTION. 



SAMPLE 

11 

010050 

FD 

FILE-A BLOCK 5 RECORDS RECORDING F LABEL RECORDS 

omitted 

SAMPLE 

12 

010100 


DATA RECORD REC-A. 



sample 

13 

010200 

01 

REC-A. 



SAMPLE 

14 

010250 


02 CODE-TEST PICTURE X, 



SAMPLE 

15 

010300 


02 NAME-FIELD PICTURE A<20). 



SAMPLE 

16 

010350 


02 DATE-FIELD. 



sample 

17 

010400 


03 MONTH-FIELD PICTURE 99. 



SAMPLE 

lb 

010450 


03 DAY-FIELD PICTURE 99. 



SAMPLE 

19 

010500 


03 YEAR-FIELD ' PICTURE 99. 



SAMPLE 

20 

020050 

FD 

FRE-B BLOCK 1 RECORDS RECORDING F LABEL RECORDS 

omitted 

SAMPLE 

21 

020100 


DATA RECORD REC-B. 



SAMPLE 

22 

020200 

01 

REC-8 PICTURE X(7). 



SAMPLE 

23 

030050 

FD 

file-c block 5 recuros recording f label records 

omitted 

SAMPLE 

24 

030100 


DATA RECORD REC-C. 



SAMPLE 

25 

030200 

01 

REC-C. 



SAMPLE 

26 

030250 


02 DATE-TEST. 



SAMPLE 

27 

030300 


03 YEAR-FIELD PICTURE 99. 



SAMPLE 

23 

030350 


03 MONTH-F I E LO PICTURE 99. 



SAMPLE 

29 

030400 


03 DAY-FIELD PICTURE 99. 



SAMPLE 

30 

030450 


02 NAME-FIELD PICTURE X(20). 



sample 

31 

050050 

WORKING-STORAGE SECTION. 



SAMPLE 

32 

050100 

77 

QUALIFY-SWITCH PICTURE S9 COMPUTAT IONAL-3 . 



SAMPLE 

33 

050150 

77 

TABLE-LIMIT PICTURE S9 ( 5 ) COMPUTATIONAL VALUE 0. 



SAMPLE 

34 

050200 

77 

TABLE-USED PICTURE 59(5) COMPUTATIONAL. 



SAMPLE 

35 

050250 

77 

TABLE-X PICTURE S9(5) COMPUTATIONAL 

• 


sample 

36 

050350 

01 

THF-TABLE. 



SAMPLE 

37 

050400 


02 TABLE-ENTRY OCCURS 100. 



SAMPLE 

38 

050450 


03 TABLE-CODE PICTURE X. 



SAMPLE 

39 

050500 


03 TABLE-DATE PICTURE 9(6). 



sample 

40 

100O00 

PROCEDURE DIVISION. 



SAMPLE 

41 

100100 

RE' 

-MARKS SECTION. 



SAMPLE 

42 

100105 

R-l 

M. 



SAMPLE 

4 3 

100110 


note . 



SAMPLE 

44 

100115 


THIS PROGRAM USES A DECK OF SELECTOR CARDS 

IN 

THE PAR T I ALSAMPLfc 

45 

100120 


COPYING OF AN INPUT TO AN OUTPUT REEL OF TAPE. 


SAMPLE 

46 

100125 


THE PROCESSING PROCEEDS BY CHECKING EACH INPUT 

RECORD 

sample 

47 

100130 


AGAINST EACH SELECTOR CARO, AND WRITING THE 

qualifying 

SAMPLE 

48 

100135 


RECORDS— REFORMATTED— TU THE OUTPUT FILE. 



SAMPL1 

49 

101050 

THE-M»ST SECTION, 



SAMPLE 

50 

101150 

INITIALIZE. 



SAMPLE 

51 

101200 


OPEN INPUT FJLE-B. 



sample 

52 

101250 


MOVE 0 TO TABLE-USED. 



SAMPLC 

53 

101350 

read-in. 



SAMPLE 

54 

101400 


READ FILE-B AT END GO TO FINISH OF THE-FIRST, 



SAMPLC 

55 

101450 

STOP-READ. 



sample 



t5-92 »*« u 


mill 


TO OEHONSTIUTE COMCMMT f OR COlOt 


(Nil TIC 


COM.iNY NAME 


• •• 

• 

I 

I 

001 (41) 

RE-MARkS section 

1 

I 

002 (42 ) 

R-M 


(4 J ) 


I 
I 

00 ) 

NOTE 
I 
I 

004 (44) 
THIS PROGRAM USES 

A OECK OF 
SELECTOR 
CARDS IN the 
PARTIAL COPYING 
OF AN INPUT 
TO AS OUTPUT REEL 
OF TAPE 
I 
I 

005 (46) 
THE PROCESSING 

PROCEEDS BY 
CHECKING EACH 
INPUT RECORD 
AGAINST each 
SELECTOR CARO/ 

AhD writing the 
Qualifying 

RECORDS — 
REFORMATTED— To 
the output file 
i 

i 

006 (49) 
THE-PIRST SECTION 


! 

1 

007 (50) 

INITIALIZE 


I 

I 

-008—- ( 51 )♦ 


• OPEN INPUT • 

• PILE-B 4 
* • 

I 

I 

♦ —009 (52 )♦ 

HOVE 0 TO TABLE- I 
I USED I 

— — — -— — 4 

I 

I 

*••• COME From 
PG Aa BOX 01T 
PG AA BOX 0)1 
I 
I 

010 (5)) 

REAO-In 

l 

I 

♦ Oil ( 5* >• 

♦ • 

• READ PILC-B • 

• I 

• l 


I 

I 

.012. (54) 

.4 •. 


♦ AT (NO ♦— — 

•• .4 PALSI 

• ♦ ,1 

•• .• 

•• .4 
I TRUE 
I 

*•“•—013 — (54)# 

I G3 TO FINI5H OF I 
I tme-first J 

♦ .... 

! 

I 

GO TO •••• 

PC AR BOX 032 


CONE FROM 
PG AA BOX 012 
I 
I 

015 
I 
I 
I 

•••• COME FROM 
PG AA BOX 026 

1 

016 (55) 

STOP-READ 

l 
l 

.017, 


.• HAS THIS 4 
-♦ STATEMENT BEEN 
•. ALTEREO 
4. 7 •• 


• • .4 

I NO 
I 

♦ Ox S 134)* 

I GO TO USE-RECI i 

♦ — » 

l 

I 

•••4 GO TO •••%* 
PC AA BOX 020 


••44 COME FROM ••4*e 
PG AA BOX 022 
I 
1 

♦ 028 (62U 

t OTHERWISE 1 

♦ — 4 

I 

I 

— -029— (6BU 
I MOVE RCC-B TO I 
I table-entry I 

I ( TABLE-USED ) 1 

♦ — — - — -♦ 

I 

I 

•••• COME FROM 4***. 

PG AA BOX 027 
I 
I 

♦——030 (64 ) ♦ 

I GO TO REAO-IN I 


— *46* COME PROM •»•• 

PC AA BOX 019 
I 
1 

020 ( 57) 

USE-RECB 

I 

I 

— 021---( SB )♦ 

I AOD l TO TABLE- I 
I USED I 

♦ — 4 

I 

I 

•022. (59) 

• * •• 

• • *. 

.• IF TABLE- 4. 

USED CREATER 4 

false •. table-unit ,» 

• • .• 

•• .4 

•, .* 

I TRUE 
I 

♦ 023— - < 60 )♦ 

IOISPLAY • TOO MANY! 

I selection 1 

I statements.* I 

I UPON CONSOL t I 


I 

I 

♦ 024— (60)4 


DISPLAY 


I 

t 

025 — -(61 ) 4 

I AUER STOP-RfAO I 

i to proceed td i 

I REAn-lN I 

4- — 

I 

I 

♦— 026— (61 ) 


ALTER 

• • 

PG AA BOX 016 


-•••• GO TO 4«*# 
PG AA BOX 0)0 





SAMPLE TO DEMONSTRATE CQHCHART FOR COBOL 


3-93 

C HU T / C 


ELEMENT index 


TYPE 

STMT NAME 

references in deck sequence 

02 

14 CODE-TEST 

96 

E-Q 



02 

16 DATE-FIELD 





02 

26 DATE-TEST 

96 

E-Q 



03 

18 DAY-FIELD 


(SEE DUPLICATE 

NAME 

below) 

03 

29 DAY-FIELD 





PARA 

96 E-Q 





PARA 

73 EACH-INPUT 

73 

each-input 



SECT 

95 EACH-Q 

89 

Q-B 



ED 

11 FILE-A 

70 

initialize 





73 

EACH-INPUT 





83 

FINISH 



ED 

20 FILE-B 

50 

initialize 





53 

READ-IN 





65 

FINISH 



ED 

23 FILE-C 

70 

initialize 





83 

FINISH 



PARA 

65 FINISH 

S3 

read-in 



PARA 

83, FINISH 

73 

each-input 



PARA 

50 INITIALIZE 





PARA 

70 INITIALIZE 





03 

17 MONTH-FIELD 


(SEE DUPLICATE 

NAME 

BELOW) 

03 

28 MONTH-FIELD 





02 

15 NAME-FIELO 


(SEE DUPLICATE 

NAME 

BELOW) 

02 

30 NAME-FIELD 





PARA 

87 0- A 





PARA 

89 Q-B 

89 

Q-B 



sect 

86 QUALIFIER 

73 

EACH-INPUT 



77 

32 OUALIFY-SWITCH 

73 

EACH-INPUT 





87 

Q-A 





89 

Q-B 





96 

C-Q 



PARA 

42 R-M 





sect 

41 re-marks 





PARA 

53 READ-IN 

57 

USE-RECB 



01 

13 REC-A 

73 

EACH-INPUT 



01 

22 REC-8 

57 

USE-RECB 



01 

25 REC-C 

73 

EACH-INPUT 



PARA 

55 STOP-READ 

57 

USE-RECB 



03 

38 TABLE-CODE 

96 

E-Q 



03 

39 TABLE-DATE 

96 

E-Q 



02 

37 TABLE-ENTRY 

57 

USE-RECB 



77 

33 TABLE-LIMIT 

57 

USE-RECB 



77 

34 TABLE-USED 

50 

INITIALIZE 





57 

USE-RECB 





89 

Q-B 



77 

35 TABLE-X 

87 

Q-A 





89 

Q-B 





96 

E-Q 



SECT 

49 THE-FIRST 





SECT 

69 THE-SECONU 
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s 

A M 

PIE TO DEMONSTRATE 

\ 

CQMCHART FOR 

COBOL 

C H A R T / c 



P R 0 C E D U 

R E 

S K E i 

E T 0 

N 


procedures tn deck sequence 


REFERENCES 

in deck sequence 


41 

RE-MARKS 






42 

R-M 






44 

THE-FJRST 






50 

INITIALIZE 






53 

READ-IN 


FROM 

57 

USE-REC8 





ro 

65 

FINISH 


55 

STOP-READ 


from 

57 

USE-RECB 





to 

57 

USE-RECB 


57 

USE-RECB 


FROM 

55 

STOP-READ 





TO 

53 

read-in 





ro 

55 

STOP-READ 


65 

FINISH 


from 

53 

READ-JN 


69 

TH6-SEC0ND 






70 

INITIALIZE 






73 

each-input 


FROM 

73 

EACH-INPUT 





TO 

73 

each-input 





TO 

S3 

FINISH 





TO 

86 

qualifier 


63 

finish 


FROM 

73 

EACH-INPUT 


86 

QUALIFIER 


FROM 

73 

EACH-INPUT 


87 

Q-A 




- 


89 

Q-B 


from 

89 

Q-B 





TO 

89 

Q-B 





TO 

95 

EACH-Q 


95 

EACH-Q 


from 

89 

Q-B 


96 

E-Q 
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Samp 

L E 

TO DEMONSTRATE COMCHART fpR LOQ I r -DFS I GN C H 

A 

R T / 

1 

sample 

N 


•THIS PROGRAM USES A SET OF SELECTOR CAROS 

•V 

00005 

2 




'TO CHOOSE SPECJFIEO RECOROS FROM A REEL' 

V 

O0010 

3 




'OF MAGNETIC TAPE AND COPY THEM TO A' 

V 

00015 

4 




'SECOND TAPE, REFORMATTING THEM FOR A SORT 

•V 

00020 

5 




' IN THE PROCESS, ' 


00025 

6 


N 


'EDIT. FILE PURPOSE' 

V 

00030 

7 




•EDIT. A. ...INPUT TAPE • 

V 

00035 

8 




'EDIT. 8. ...SELECTORS • 

V 

00040 

9 




'EDIT. C... .OUTPUT TAPE* 


00045 

10 

the-first s 


'READ THE SELECTORS INTO A TABLE.' 


00103 

11 


0 

THE-SECOND NO 

YES 'WERE THERE TOO MANY FOR CORE 7* 


00110 

12 


0 


'DISPLAY "TOO MANY ..." To OPERATOR.' 


00115 

13 


S 


•BY-PASS The REMAINING SELECTORS.' 


00120 

14 

the-second 

I 

•OPEN THE INPUT AND OUTPUT TAPES.' 


00210 

15 

each-input 

I 

•read an input record, • 


00220 

16 


0 

FINISH ENO MORE 'ENO-OF-FUE ?' 


00225 

17 


s 

qualifier 

'USE SUBROUTINE TO SET QUALlFY-SWITCH. ' 


00230 

18 


D 

EACH-INPUT NO 

YES 'DOES THE RECORD QUALIFY?' 


00235 

19 


P 


'FORMAT THE OUTPUT RECORD.' 


00245 

20 


□ 


'WRITE THE OUTPUT RECORD.' 


00250 

21 


G 

EACH-INPUT 



00255 

22 

finish 

□ 


•CLOSE ALL FILES,' 


00265 

23 


G 

SUPERVISOR 

•RETURN TO SUPERVISOR.' 


00270 

24 


E 




00300 

25 

QUALIFIER n 

•THIS SUBROUTINE DETERMINES WHETHER THE' 

V 

00305 

26 




•CURRENT RECORD IS SPECIFIED BY THE' 

V 

00310 

27 




•SELECTION DECK,' 


00315 

28 


P 


'SET SUBSCRIPT ■ 0.' 'SET SWITCH OFF'. 


00320 

29 

REF.Q-A 

P 


'SET SUBSCRIPT ♦ 1. • 


00325 

30 


0 

Q-X YES MORE 

' IS TABLE EXHAUSTED ?' 


00330 

31 


s 

EACH-Q 

'USE SUBROUTINE TO MAKE ACTUAL TESTS.' 


00335 

32 


D 

Q-X YES NO 

' 01 D RECORD QUALIFY with CURRENT SELECTOR?' 


00340 

33 


G 

REF.Q-A 

•CONTINUE, i 


00345 

34 

Q-X 

N 


'IF THE RECORD QUALIFIED BY ANY SELECTOR,' 

V 

00355 

35 




'THE SWITCH HAS BEEN SET ON.' 'OTHERWISE IV 

00360 

36 



T IS STILL OFF.' 


00365 

37 


G 

EXIT 

•EXIT. ' 


00370 

38 

EACH-Q 

N 


•TO CHANGE SELECTION RULES, JUST CHANGE' 

V 

00400 

39 




'THIS ROUTINE.' 


00405 

40 


P 


'IF THE CODE OF The CURRENT RECORD' 

V 

00415 

41 




•MATCHES ThE CODE OF THE CURRENT' 

V 

00420 

*2 




'SELECTOR ENTRY, ' 

V 

00425 

43 




'AND THE DATE ON The RECORD IS ON OR AFTER' 

V 

00430 

44 




'THE DATE JN THE ENTRY, • 

V 

00435 

45 




'OR IF 1 HE CODE IN THE RECORD IS BLANK,' 

V 

00440 

46 




'TURN THE OUALIFY-SWITCH ON.' 


00445 

47 


G 

EXIT 



00465 

hagnostic 

MESSAGE count 

0 





3-96 


PAGE U 


S A M A l I 


TO DEMONSTRATE COHCHART FOR L001C-D9S1CN 


CHART/l 


COMPANY NAME 


44444 

444 


I 

I 

001 (1) 


Sample 


i 

I 

002 ( 1 > 
THIS Program USES 
A SET OF SELECTOR 
CARDS 
TO CHOOSE 
S’ECIPIEO RECORDS 
From a reel 
DP MAGNETIC TAPE 
AND COPY THEM TO 

A 

SECOND TAPE, 
REFORMATTING THEM 
FOR A SORT 
IN THE PROCESS. 

I 

I 

003 (A) 

FILE PURPOSE 

A..,, INPUT TAPE 
0... .SELECTORS 
C... .OUTPUT TAPE 
I 
I 

00* (10) 

THE-FIRST 

I 

I 

♦—005 (10) 


4 READ THE * 

SELECTORS INTO 4 
• A TABLE. 4 


I 

1 

.006. (11) 


.* 


WERE THERE TOO 

NO •. MANY FOR . 

•. CORE ? ,• 


I YES 
I 

♦ —007 ( 12 )* 

• DISPLAY • TOO 4 
• NASV ...» TQ ' • 

♦ OPERATOR. • 


I 

I 

♦—008— (13) 


By-PASS THE • 
remaining 4 
SELECTORS. • 


l 

I 

COME FROM 4444 
PG AA BOX 006 
I 
I 

009 (14) 

THE-SfCOND 

I 

I 

♦ -.010 ( 14 >♦ 

• OPEN THE INPUT 4 

• And output • 

• tapes. • 


I 

i 

• ••• COME FROM 4444- 
PG AA SOX 019 
PC AA SOX OlO 
I 
t 

Oil (15) 
EACH-INPUT 


-4444 COME FROM 4444 
PG AA BOX Oil 
1 
1 

♦ 012 C 1 3 )♦ 

• 4 

6 READ an INPUT 4 
• RECORD. • 


I 

I 

•013. (16) 

6. 


eno-of-pile t 
• • 
p. .• 


ENO 


I MORI 
I 

♦—014 — -117) 

• 4 

* USE 4 

• SUBROUTINE • 

• TO set CUAIIPY- • 

• SWITCH. • 

• • 

PG AB BOX 023 


-4444 COME FROM 4444 
PC AA BOX 013 
I 
I 

019 (22) 

finish 

I 

I 

♦ 020— (22)4 


• CLOSE All 4 
• FIlCS. 4 


I 

I 

• 015. US) 

4. 


-♦ DOES THE RECORO ♦ 


QUALIFY? 


.6 


I 

I 

♦— oil-— (27)* 

I RETURN TO I 
I SUPERVISOR. I 


•44* GO Tn 4444 


I YES 
I 

♦ 016— (19)4 

JFORMAT THE OUTPUT! 

I RECORO. I 

—————— 4 

l 

l 

♦— 017— (20)4 

4 4 

4 WRITE THE 4 
4 OUTPUT 4 
4 RECORO. 4 


I 

I 

*4444 GO TO 4444 
PG AA BOX Oil 


• 44* 


I 

I 

r.o T*) 
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DYNACHART 

Application Programming Company 

GENERAL 

DYNACHART accepts COBOL programs as input and produces a flowchart 
and diagnostic messages as well as optional individual listings of the 
source program, and cross references within the source program's Data 
Division only on both the Data and Procedure Divisions. 

DYNACHART can be implemented on any computer system capable of 
supporting a COBOL compiler and configured with at least 30K characters 
of core, one disc or four tape units, one card reader, and one line 
printer. DYNACHART is written in a minimum subset of COBOL. 

It leases for $4,400 the first year. Maintenance use charge for 
subsequent years is $700 annually. 

Package Output 

Source Program Listing - Each line consists of an 80-80 image 
of the source card preceded by a generated line 
number. 

Flowchart - Detailed flowchart in same logical order as the 
program source code. Many features under user's 
control . 

Label Cross Reference - Labels are alphabetically listed as 
are defining source code sequence number and all 
statements referencing label. 

Note: DYNACHART is one of the most expensive documentation packages. 

Its output features are not so unique as to justify the cost of 
the package. 
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EZFLOW 

Systonetics Corporation 

GENERAL 

EZFLOW accepts FORTRAN source programs, reformats and renumbers 
statements, derives a cross-reference list between statement labels and 
references of original and new program versions, produces a statement 
number reference table that shows use and location of numbers on 
restored flowcharts, and produces a new source deck listing. The package 
uses a default option control card when none of the option control cards 
are needed. 

The package runs on IBM 360/30 and up (OS), with 1 10K bytes of core 
storage; CDC 6000 Series (SCOPE), with 32K bytes of core storage. 
Peripherals include a card reader and line printer, and optionally a 
disc or tape. The source language of this package is FORTRAN IV. 

EZFLOW is available in two versions off-the-shelf: for the CDC 

6000 series and for the IBM 360 or 370 series. The price is $3,500 for 
a three-year use license as a one-time charge. 

PACKAGE OUTPUT 

Flowchart - This is a logic flowchart of the restored 


deck. This is a single column chart of rectangular 
blocks and diamond-shaped boxes, one source code 
statement is equal to one block on the chart. 
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Input and Output Source Deck - The package punches and prints 
a copy of the output source deck and prints a 
listing of the input deck. 

Cross-Reference List - This listing of statement labels and 
references shows the old and resequenced source 
code label numbers and the source list line 
number. 

Statement Reference Table - This table summarizes the program 
flow by giving the use and location of numbers 
that are in parentheses in the flowchart. 

Note: EZFLOW has automatic conversion to and from the BCD and 

EBCDIC character sets. 



^-100 


* - 

* - * 

1 


2 

r 

3 

C 

A 

C 

5 

c*« **> 

6 

C 

7 


8 


9 


10 


11 


12 


13 


1A 

C 

15 

95 

16 


17 

C 

18 


19 

C 

20 

51 

21 


22 


23 

152 

2A 

C 

25 

8A 

26 

C 

27 

20 

28 

5000 

29 

A 

30 

80A1 

31 

2 

32 

C/ 

33 

C 

3A 

63 

35 


36 

77 

37 


38 

C 

39 

AOOO 

AO 


A 1 

2000 

A2 

8 

A3 

7 

AA 

1000 

A5 

50 

A6 

78 

AT 


A8 



EZFLOW * - 
SUBROUTINE SAMPLE 


PROCESSING ROUTINE MAIN 


0 tCC .C,» 


I 


THIS IS AN EXAMPLE TO DEMONSTRATE SOME OF THE FEATURES 
OF E Z F L 0 W 

•ssasaaaBssasasaassaasaaaBsaaaaaasaBsaaaaBaaaaaeaBaaaBBaBaaaaama 

NOTE THAT STATEMENTS OF THE SAME TYPE ARE ALL GROUPED TOGETHER 


DIMENSION A I 10 I. 
DIMENSION 

DOUBLE PRECISION B(20) 
COMPLEX • 16 C I 20 I 

REAL • 80 

DATALABEL/ 


Z< SI, X X 
01501 .LABE 


THIS IS A SAMPLE OF A 


EOUI VALENCE 


( A ,0 I 


Z (1000 ) .HXYZI 
1101, ENDD 01 2 


DATA STATEMENT 
(C , D I 


3 1 
0 I 


THIS IS AN EXAMPLE OF A MULTIPLE RETURN ROUTINE 


C2 , C20, INDEX) 

LABEL 2 C2 I 


CALL SUB2 I A. B 

CALL SUB 1 ( A.B, 6HLABEL 

EXAMPLE OF A COMPUTED GO TO STATEMENT 
GOTO (51. 63. 2, A. 2. BA, 95, BA), INDEX 
EXAMPLE OF 00 LOOP PROCESSING 
DO 152 I • M , NOFOQ 

A (I) « Z( I) 

HXYZI I ) » 1 

ENDDO ( I ) = ( I ♦ ll»Al II 

EXAMPLE OF ARITHMETIC IF STATEMENT 
I F ( ENODO ( 10 )- 1 23A56* S INI FLOAT! I NDEX ))) 1000,2000, AOOO 
tXAMPLE OF READ STATEMENT 

READ! 5. 5000, £NO a 2,£RR» 1000) A 

FORMAT ( 10EB.29 

W RITE (6 , 8061 ) A 

FOR MAT ( *1 INPUT DATA A •// C 10E8.2M 

RETURN l 

THIS COMMENT CARD WILL START A NEW PAGE (SLASH IN COLUMN 2) 
EXAMPLE OF A 00 LOOP TERMINATING IN A LOGICAL IF STATEMENT 
DO 7 7 K - 1 . 50 

A ( K I >K * K* A I K ) 

IF (MOO (K.IO) .EQ . 0 ) REAOt 5. 5000, END *2, ERR* AOOO) C.D 

GOT 0 8 

EXAMPLE OF ANOTHER TYPE of multiple return statement 

CALL SUR3IA, B ) , RE TURNS ( 2 , 20) 

G0T050 

T I N U E 

• M , N 
J 

2 

6,78 I A 
I •A* , E18.5) 

RETURN 
0 


CON 
0 0 7J 
A U). 
R ETURN 
WRITE ( 
FORMAT 

EN 


EZFLOW «-*-• PROCESSING ROUTINE - - SAMPLE 


N E W - 

0 L 0 S_ 

T A T E M E N T 

NUMBER 

CROSS 

R E F E 

R E N C 

NEW 

OLO 

LINE 


OLD 

NEW 

LINE 

10 

95 

15 


2 

70 

31 

20 

51 

20 


A 

60 

29 

30 

152 

23 


7 

130 

A3 

AO 

8A 

25 


8 

120 

A2 

50 

20 

2T 


20 

50 

27 

60 

A 

29 


50 

150 

A5 

70 

2 

31 


51 

20 

20 

80 

63 

3A 


63 

80 

3A 

90 

77 

36 


77 

90 

36 

100 

AOOO 

39 


78 

180 

A6 

110 

2000 

Al 


8A 

AO 

25 

120 

8 

A2 


95 

10 

15 

130 

7 

A3 


152 

30 

23 

1A0 

1000 

AA 


1000 

l AO 

AA 

150 

50 

A5 


2000 

110 

Al 

160 

5000 

28 


AOOO 

100 

39 

170 

80A1 

30 


5000 

160 

28 

180 

78 

A6 


S0A1 

170 

30 
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*-* E 2 F L 0 W PROCESSING ROUTINE SAMPLE 



SUBROUTINE SAMPLE 1 A , B ,CC .C , 01 

SAMP 

10 

c — « 

■ •B883Kssssss4Sx3xx3a*9«xss*3a*xsaas3S9a3sa«aaiamx*sB*aassaxsasaaia 

*■» SAMP 

20 

c 

THIS IS AN EXAMPLE TO DEMONSTRATE SOME OF THE FEATURES 

SAMP 

30 

c 

OF E Z F L 0 M 

SAMP 

40 

c 

NOTE THAT STATEMENTS OF THE SAME TYPE ARE ALL GROUPED TOGETHER 

SAMP 

60 


DIMENSION A< 10), Z(5) .XXYZt 10001 ,WXYZ(3> 

SAMP 

70 


DIMENSION O(SO) .LABEL! 10) .END00I201 

SAMP 

80 


DOUBLE PRECISION B(20) 

SAMP 

90 


C0MPLEX*16 C 1 20) 

SAMP 

100 


REAL»8 0 

SAMP 

110 


OATA LABEL/* this IS A SAMPLE OF a DATA STATEMENT •/ 

samp 

120 


EQUIVALENCE IA,8),(C,0) 

SAMP 

130 

c 

THIS IS AN EXAMPLE of a hultiple return routine 

SAMP 

160 

10 

CALL SuB2 1A.B.C70.C50. INDEX) 

SAMP 

150 


CALL SUB 1 (A.B.6HLA8EL ,< LABEL 2 *.S70> 

SAMP 

160 

c 

example of a computeo go to statement 

SAMP 

170 


GO TO (20.80,70.60.70,60.10.60). INOEX 

SAMP 

180 

c 

EXAMPLE of do loop processing 

SAMP 

190 

20 

00 30 I=M,NOFOO 

SAMP 

200 


A! I ) * Z I I ) 

SAMP 

210 


WXY2 ! I)«I 

SAMP 

220 

30 

ENOOOI I )-( I + ll*AI I ) 

SAMP 

230 

c 

EXAMPLE OF ARITHMETIC if statement 

SAMP 

260 

*0 

IF !ENDDO( 10)-1236S6*SIN(FLOATIINOEXIH 160.110.100 

SAMP 

250 

c 

example of read statement 

samp 

260 

so 

READ (5,160,EN0*70,ERR»160! A 

SAMP 

270 

60 

WRITE' (6,170) A 

SAMP 

280 

70 

RETURN 1 

SAMP 

290 

C/ 

THIS COMMENT CARD WILL START A NEW PAGE (SLASH IN COLUMN 2) 

SAMP 

300 

c 

EXAMPLE OF A 00 LOOP TERMINATING IN A LOGICAL IF STATEMENT 

SAMP 

310 

80 

00 90 K=l.50 

SAMP 

320 


A(K)=K*K»A(K) 

SAMP 

330 

90 

IF (MODOC, 10). EQ.O) READ (5.1 60, E NO” 70 • ERR* 100 1 C.D 

SAMP 

360 


GO TO 120 

SAMP 

350 

c 

EXAMPLE OF ANOTHER TYPE OF MULTIPLE RETURN STATEMENT 

SAMP 

360 

100 

CALL SUB3 (A,B),R£TURNS(70,50) 

SAMP 

370 


GO TO 150 

SAMP 

380 

no 

CONTINUE 

SAMP 

390 

120 

00 130 J-M.N 

SAMP 

600 

130 

A { J ) * J 

SAMP 

610 

160 

RETURN 2 

SAMP 

620 

ISO 

WRITE (6. ISO) A 

SAMP 

630 


RETURN 

SAMP 

660 

C 


SAMP 

650 

160 

FORMAT (10E8.2) 

SAMP 

460 

170 

FORMAT (*1 INPUT OATA A '//I10EB.2II 

SAMP 

670 

180 

FORMAT (*A«*E18.5) 

SAMP 

680 


ENO 

SAMP 

690 
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PROCESSING ROUTINE 


SAMPLE 


I SUBROUTINE SAMPLE ( A. ft, CC,C , * , * ,0 1 


I 

THIS IS'AN EXAMPLE TO DEMONSTRATE SOME OF THE FEATURES 

I 

I 

OF E l F L 0 U 

I 

I 


NOTE THAT STATEMENTS OF THE SAME TYPE ARE ALL GROUPED TOGETHER 

I 


I DIMENSION AUO),2(5),XXY2llOOO),HXVZJ3) 
I DIMENSION Q<50),LAB£L(10),ENDDO(20I 


I DOUBLE PRECISION BI20) 


I CCMPLEX*16 C 1 20) 


I RE AL*8 0 


1 DATA LABEL/* THIS IS A SAMPLE OF A DATA STATEMENT ' •/ 


I EQUIVALENCE (A.Bl.IC.D) 


I 


THIS IS AN EXAMPLE OF A MULTIPLE RETURN ROUTINE 


10 


>1 CALL SUB2 (A,B.C70,C50.INOEXI 


I I F SUBROUTINE RETURNS 
I RETURN =»i .2 

I GO TO 70 ,50 


I CALL SUBI ( A, B, 6HL ABEL ,• LABEL 2 ',C70) 

♦ — ♦ 


I I F SUBROUTINE RETURNS 
I RETURN -l 
1 GO TO 70 

I 

EXAMPLE OF A COMPUTED GO TO STATEMENT 

I 


111 ) 


II?) 

I 

I 

-♦ 


I l F COMPUTEO GO TO ON INDEX 

I INDEX • l ,2 ,3 ,A ,5 ,6 ,7 

I GO TO 20 ,80 ,70 ,60 ,70 ,A0 ,10 


,8 

,50 


III) 


I (2) 


Ml) 

I 

I 

-♦ 


EXAMPLE OF 00 LOOP PROCESSING 


20 

♦ <- 


->. DO 
— . 30 


.(A) 


I*M,NOFOO . 


I 

I 

--> 30 >1 


A( I ) = Z C I) 

WKYZ 1 1 ) “I 

ENDOOI 11*11*1) *A (I) 


AO 


J 

EXAMPLE of ARITHMETIC if statement 

I 

-> > > > > > >-l 

15) . * * . 

♦ » IF • 

I (ENDOOI 10 )-123A56*SINlFLOAT( INDEX) ) ) 

I . . * 

I • . • 

I I 

MINUS I 7ER0I PLUSI 

♦ — * — ♦ ♦ — * — ♦ * — , — » 

ICO TO I IGO TOl IGO TOI 

I 1A0 I | 110 I I 100 1 

♦ -♦ ♦ » ♦— * 
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example of read statement 


so 


->l REAO I5.160.ENO-70.ERA-IAO) A 


» 


1(6) 


161 . • • . 

• • IF * . TRUE 

. ENO OF FILE . 

• . I . • I 

• • • I 

FALSE I |I6) 


I 

t 

I 

( 6 ) . • • 
. • IF 


• . I . • 

FALSE I 
I 
I 
I 


♦— 

1 

GO TO 70 

1 




> . 

TRUE 


1 

1 

1 



1(61 


i 

GO TO 1*0 

i 


60 

♦ - 

>| 

WRITE (6.170) A 


~ 1 

117) 

TO 

♦ - 

>| 

RETURN l 



1 


ezfloh 


PROCESSING ROUTINE SAMPLE 


/ THIS COMMENT CARO MILL START A NEW PAGE (SLASH IN COLUMN 21 


EXAMPLE OF A 00 LOOP TERMINATING IN A LOGICAL IF STATEMENT 

I 


80 >. 00 >(8 , 

< . 9Q 


K*t,50 


I A(K)>K»K*A(K) 


-> 90 


I 

(91 . * * . 

♦ — • IF • — ♦ TRUE 

I (MODIK, 10I.EQ.0) I 

♦ — * . . * ♦ 

* . • 

FALSE I 
I 
I 
» 

I 

I 

» 

I 

I 

I 

I 

I 

I 

I 

I 


I 

*— ♦ 


I 

I 

1(91 


I REAO (5.160, END»70,ERR-100) C,D | 

♦ * 

1 

(9) . • * . 

• • IF • . TRUE 

. ENO OF FILE . 

• . . • I 

• . • I 


FALSE 


119) 


I GO TO 70 | 

♦ 


(9) . • • . 

• • IF * . TRUE 

. I/O ERROR . ♦ 

• . - • I 

* . • I 

FALSE I ||9I 

I — . 

I I GO TO 100 | 

^ ^ | — ~ — — - — ^ 
->-♦ ' < < < » 


->- 

♦ ♦ — ♦ 

1 GO TO 120 1(10) 
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100 


EXAMPLE OF ANOTHER TYPF OF MULTIPLE RETURN STATEMENT 

im> 

>1 CALL SUB3 (A.BI.RETURNSI70,50> ♦ 

;T; SUBROUTINE RETURNS } ,U1 

| RETURN *1 *2 I 

1 GO TO 70 >50 


1 GO TO 150 1112) 


110 



CONTINUE 



'♦ 


120 ->• 00 .113) 

♦ < . no 


J-M.N . 


| •••< 

I 

♦ no 



At J)*J 




140 

150 


160 

170 

180 


>1 RETURN 2 + 

>J WRITE 1 6. 1 BO) A 

♦ ' 

| return 



>1 FORMAT (10E8.2) ->,» 

>1 FORMAT Cl INPUT DATA A •//I10E8.2)) 

>) FORMAT CA««E18.5) _ + 

♦ END 



• 

1 

• 

1 

• 

m 

/FLOW ■ 

STATEMENT 

• - * ■ 


number type 

10 

3 GO 

20 

3 GO 

30 

A 00 

AO 

3 GO 

50 

1 CALL 

60 

3 GO 

70 

1 CALL 
9 IF I/O 

80 

3 GO 

90 

8 00 

100 

5 IF 

no 

5 IF 

120 - 

10 GO 

130 " 

13 00 

l AO 

5 IF 

150 

12 GO 

160 

6 I/O 

170 

7 I/O 

180 

1A I/O 


* - • 


PROCESSING ROUTINE SAMPLE 


BLOC K 1SL 


R eferencinq 




T VSC 


....unc a TVDC 


, 3 GO 

, 11 CALL 

, 2 CALL t 3 GO 

, 11 CALL 


, 9 IF I/O 


, 6 1/0 


- • - ♦ 
number type 


, 6 I/O 


9 IF 1/0 



FACTS 


Bonner and Moore Associates, Incorporated 


GENERAL 

FACTS accepts FORTRAN source programs as input, analyzes programs 
and subroutines, and produces cross-referenced information according 
to the option selection by the programmer. 

The package runs on the Sigma 7 computer. 

PACKAGE OUTPUT 

Source Listi ng - Source statements of the program are 
automatically listed. 

Program Reports - Six program reports are generated: 

(1 ) Common Report 

(2) Local Report 

(3) Format Statement 

(4) Statement Label Report 

(5) Recap 

(6) Global Report 



MI-33-1 Bonner Sc Moore Associates, Inc. 



••WRJAPE /LC0M / C8KP0N REP0RT 


cr> 

page 


VARIABLE 


appearances 


i ^ ^ * ############# 


N'fNE * type *> declarative * 


DEFIMTI0NAL 


REFERENCE 


N V 1 * I • C0C5 « 0017 C021 ■ * C037 

, NV2 « I • OOCS # 0019 * 0017 0019 0023 0037 

,* * . •*' 

All variables *Com- * FACTS generated * FACTS generated statement *Four digit FACTS generated st 
named in blank* plex * statement num- *, numbers in which variable *ment numbers in which the bla 
common are *Dou- *bers in which *name is defined (as in ^common name is referenced (as 

printed . * ble *the blank com- #left hand side of arith- bright hand side of arithmetic 

alphabeti- * pre- *mon variable ^ j Emetic statement). * statement) . 

cally. * ci- *name appears in 4? t 

* sion *a declarative * * 

Each variables*J!nte- ^manner; (dimen- * * 

; type is indi- * ger *sion, equiva- * * 

? cated by one *Logi- *lence state- * * 

of the follow-* cal *ments, etc.) by * * 

ing one- *Real *four digit * ^ 

character * * sequence num- * # . 

codes. * bers. * * 


Figure 6—1. Common Report 
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S otoRTApE (04)#« LOCAL report . page 00( 

u> : . i \ • ■■ 

** 4 » **#***•###* ##*<*» #*#)»## «#»##«##«*•##»**#»#* * 4 # #*#**# #«»###« »«• *»**»•«»'•«« »»»«•« ««»««»•*•*• «••<!•< 

M ; * * • ■ " \ ; • ■ 

VARIABLE » appearances 

« « • 

•«•»««•»»««««««««»«««*««»««««»««»«««»««»««««#«•« ««««««««*»*««««»««*«»««»«»»**•*«»«*•*«#«»*»•*«•««< 
« « ; * • 

NAME * TYPE « ; DECLARATIVE * DEFINITIONAL * REFERENCE 

# « # » 

*»*«*»*<>«*<>**#*< 

I * I * * 0027 0029 0032 0034 0040 #0027 0029 0032 0034 0040 

JUM T # I # * » 0001 0015 0043 

-FILE, • I # * 0039 • * 0041 i ! 


All variables *Com- * FACTS generated * FACTS generated statement* PACTS generated statement num 


named in blank* plex 

* statement num- 

* numbers in which vari- 

* bers 

in 

which the blank common 

common are 

*Dou- : 

bers in which 

* able 

name is 

defined (as 

* name 

is 

referenced, (as in 

printed 

* ble 

# the blank com- 

*‘in left hand 

side of 

* right 

hand side of arithmetic 

alphabeti- 

* pre- 

*mon variable 

* arithmetic statement) . v 

* statement) . 

cally. 

* ci- 

♦name appears in 

* 



* 




* sion 

*a declarative 

* 



* 



Each variables* inte- 

^manner; (dimen- 

* 



* 



type is indi- 

* ger 

sion, equiva- 




* 



cated by one 

*Logi- 

lence state- 

* 



* 



of the follow- 

'* cal 

*ments , etc.) by * 



# 



ing one- 

*Real 

♦four digit 

* 



* 



character 

* 

* sequence num- 

* 



* 


$ 

codes. 

* 

bers. 

* 



* 


o 

. 



Figure 

6-2. Local Report 
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••WRTAP5 104)** FORMAT STATEMENT PAGE < f 

APPEARANCES 

« . '■ f-,. 

DEFINITION *; REFERENCE ; J 


F0RMAT 

LABEL 


a 

o 

3 

3 «••»•••**««•« 

_ VWWWW wwww»w 




w 

*1 

ftl 

?oi 

• 

00 11 ' 

* 

0037 

It 

• 902 

• 

0012 

* 

00*0 

►i 

0 

0 

►1 

903 

* 

X 

0013 

# ■ 
* 

00*3 ■ ■ ■ 

0 

> 

w 

y? 

i ■' 

Sequential 

Tt 

* 

FACTS generated statement number 

* 

FACTS generated- statement number 

0 

o 

list of 

* 

in which format statement label 

* 

of the instructions which refer- 

P 

o 

w 

format num- 

* 

is defined. 

1 * 

ence the format statement label 

H* 

5 

o 

bers used 

* 


* 

listed in the first column. 


in the sub- 

* 


* 



routine or 

* 


* 

It''- 


program. 

* 


* 



v ’• * V 


<y\ 

i 

•Cn 


Figure 6-3. Format Statement Report 


801-^ 
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V! f r 

'4 ? 


«#ViRTAPE (04)#* STATEMENT LAgEU REPORT 


PAGE 00 


«•••«#•»»**•«««*«»• ft* J#*#***#*# ft# • 



statement * . 

LABEL #»***#* 


10 * 0014 

loo * 0026 


APPEARANCES 



Sequential 
list of all 
statement 
numbers ' ; < 

used in the 
subroutine 
or program. 


FACTS generated statement number in 
which the format statement labels 
is defined. 


* 

* 

* 

* 

* 

* 

* 


* 

FACTS generated statement num- 
ber of the instructions which 
reference the statement listed 
in the first column, 
column. 


4 


Figure 6-4. Statement Label Report 
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MI-33-1 Bonner it Mooro AkhocIiiIos, Inc. 


I 


* 


««xxxx 


(C3)#RECAR 


page 00' 


INTERNAL. FUNCTIONS 


« 

. # 

■ s* ■■ f 

• * '* 

NAME * DEFINEC « REFERENCED * 

« * • * * J 

*«» »«•»*»»»»»*»**»»*** * **•* *4*4 »••»*»*■»*********** # ********** * * 

XXXX (03) * OOH * « F <03) * OCO^ 

YYYY (03) * 0006 # * 


4 * 

ROUTINE ENTRyS * * 

« * 

• 4 • 

NAME * AT * * 


external NAMES 


* 


* 00C8 
•* 


« 

...» 


e*444444444***4******** 
• * 

♦ NAME * AT 

• * 

4 *«»*?***** 

» A (01) •> C0C5 

* I ABS (01 ) * 0010 

• v 


(Oil * nr, 07 


Name and location *• *'*.*********Self explanatory********************** 

of all subroutines * * 
or function entry * * 
points, or if a pro*^* * 
gram, the name 
specified in the 
PC2 name field, 
with the location * * 


* * 
* * 
* * 


blend. 


* * 


* All references in this 

* program or function tc 
♦external subroutines o 

♦functions. 

* 

* 

* 

* 

* 


Tigure 6-5. Recap Report 
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MI-33-1 Dormer U Moore Associates, Inc. 



GUflDAL REP8RT 


PAGE 0 


PROGRAM E\TRys 


PRIMARY » SECONDARY 

* 

#»•»*•»«#**«»#». #«»»«*»»»»«•* 


THIS PRQGRAM CALLS 


THIS PROGRAM CALLED BY 


MAIN 


ft 

ft 

IABS 

(01 ) 

RCTAFE 

(04) 

ft 


ft 

* 

hrTAPE 

(C4) 

XX 

(02) 

ft 



ft 

ft 

xxxx 

(03) 



ft 

„RTA(>E 

(O'*) 

* HCTAPE 

<C<t) • 

. IABS 

(01 ) 

ie£RR 

(01) 

ft 

XX 

(02) 

ft 

• 





ft 

NNN 


ft 

ft 





ft 



ft 

* 





ft 



ft 

★ 





ft 


MAIN 


List of every* program entry *A11 external references for the *A11 programs 'or subroutines of 

point defined* in the entire ‘programs dr subroutines listed in *run which call subroutines or 

run. * ‘PRIMARY. ' ‘functions listed under 

Entry points ‘Entry point * ‘PROGRAM ENTRYS. 

defined via ‘defined via * * 

the PC2 name ‘the entry * * 

field, sub- ‘statements. * * 

routine or * * * 

function * * * 

cifnhompnh * * * 


routine or 

function 

statement 


Figure 6-6. Global Report 
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FLOWGEN/F 
Cal Comp 

GENERAL 

FLOWGEN/F accepts FORTRAN source cards and produces ink-on-page 
flowcharts. It generates plot commands to drive a Cal Comp Plotter. 
It gives no other listings about the program than the flowchart. 

PACKAGE OUTPUT 

Flowchart - This is a detailed flowchart that is given on 
a ink-on-paper Cal Comp Plotter. Comments are 
enclosed in boxes. 



PLOWGEN / F SAMPLE 
PROGRAM 


- 3 - 


• * THIS IS A SAMPLE PROGRAM TO DISPLAY 

• * FEATURES OF THE CALCOMP - FORTRAN - FLOWCHART GENERATOR 
: * * * 

DIMENSION DATA (1024) 

- EXECUTABLE STATEMENTS ARE SEPARATED FROM COMMENTS 

- * UNNUMBERED NON-BRANCHING STATEMENTS ARE STACKED UP TO 

* 8 IN A BOX AS FOLLOWS 

AN = 0.1 

RF = AN * 0.01745 
XC = COS (RF) 

Y = AY +XC 
AN = AN + AD 
X = X+0.0625 
XB = 1.0 
AY = 3.0 
ANZ = 0.0 

: LOGICAL -IF- STATEMENTS ARE AS FOLLOWS 
1 IF (A.NE.B) RETURN 
GO TO 5 

: THE PREVIOUS STATEMENT REPRESENTS A -GO TO- STATEMENT 
! CALLS TO SUBROUTINES ARE AS FOLLOWS - CONTINUATION CARD SHOWN ALSO 
CALL SUB (Pl,P2,P3 
1 P4,P5,P6) 

: A -DO LOOP- IS SHOWN IN THE FOLLOWING MANNER 

5 DO 6 1=1,3 
X = X+1.0 

IF (X-2 .0) 6,6, 7 

6 CONTINUE 

! AN ARITHMETIC -IF- WAS SHOWN IN THE ABOVE -DO LOOP- 
! COMPUTED AND ASSIGNED -GO TO - ARE REFLECTED AS FOLLOWS 

7 GO TO (10,5, 1) ,K 

: NUMBERED y STATEMENTS ARE PLACED IN SEPARATE BOXES 
10 K = 1 

: UNNUMBERED STATEMENTS ..RE STACKED IN THE SAME BOX 
K = 1 
A = 1.0 
READ 12, J 

12 FORMAT ( 1A1) 

: THIS IS AN OFF-PAGE DO- LOOP EXAMPLE 
DO 13 I =0, 1 
X = X+1.0 

13 CONTINUE 

: RETURN AND STOP AND END ARE AS FOLLOWS 
RETURN 
STOP 

: AFTER THE FOLLOWING END STATEMENT IS DRAWN AN -UNFULFILLED 
: REFERENCE- STATEMENT IS LISTED ON THE PRINTER. ANY 

; STATEMENT NUMBERS OR THE WORD NONE WILL THEN BE LISTED. 

END 



Reproduced from 
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FORFLOW 

DNA System, Inc. 

GENERAL 

FORFLOW accepts FORTRAN source decks as input. It is a two-program 
system which consists of two distinct programs: FLOWA produces a flowchart 

of the source program and SEQ generates a source listing containing re- 
sequenced FORTRAN statement numbers in ascending order by fives, and changes 
all branch and formatted input/output statement numbers to agree with the 
new statement numbers. 

The package can operate on an IBM 1130 computer under control of the 
monitor system or on an IBM 1800 under TSX version 3 or MIX. Minimum 
machine requirements for the 1130 include 8K bytes of core, 1 card reader, 

1 line printer, and 1 disc. For 1800 a minimum of 10K bytes of variable 
core is required. The package itself is written in FORTRAN and includes 
some assembler subroutines. 

The package costs $480.00 for the card system and $600.00 for disc 
system. 

PACKAGE OUTPUT 

Flowchart - at some level of detail as the source program. All flow- 
chart blocks are rectangular. 

Resequenced listing - this can be a printed listing of the resequenced 
source deck, or it can be of punched cards. 
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FORTRAN VARIABLE NAME DQCUMENTER 
Data for Management Decision 

GENERAL 

The FORTRAN Variable Name Documenter accepts FORTRAN source code as 
input. The package generates a sequenced listing of a FORTRAN program, 
a numerical list of the statement numbers used in that program, and an 
alphabetical list of variable names in the program. 

The package is designed for any user's configuration that is capable 
of supporting a FORTRAN compiler. Auxiliary storage is provided by one 
disc. The package consists of two programs and a sort. Source language 
is FORTRAN. 

Purchase price is $350 for the object deck or $500 for the source 

deck. 

PACKAGE OUTPUT 

Source Listing - a listing of the FORTRAN source code. 

Statement Number Listing - a numeric listing of the program 
statement numbers. 

Variable Name Listing - an alphabetic listing of program variable 


names. 
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QUICK-DRAM 

National Computer Analysts , Incorporated 

GENERAL 

QUICK-DRAW translates source programs written in Assembler, 
AUTOCODER, COBOL, PL/I, and FORTRAN into flowcharts and related cross- 
references. It also provides a diagnostic check list and modified 
instruction list to aid with debugging. 

The system runs on IBM 360; Burroughs 25/35/55; HIS 200, 400, 600, 
800; I CL 1900; RCA Spectra 70 or 3301; and Uni vac 9400/1100. System 
supervision may be OS, TOS, DOS, MCP, DAPS, MODZ, TDOS, or EXEC 8. 
Minimum core storage is 32K bytes for DOS and TOS and 65K bytes for OS. 

Leases are $1,900 to $6,300 depending on version (3-year lease) 
and $1,400 to $2,100 a year depending on version. 

PACKAGE OUTPUT 

Listings for Assembly : 

Flowchart - This is a detailed flowchart of the program. It 
contains all the ASSEMBLY statements in logical 
groups placed in boxes whose shape is determined 
by the type of statement. 

Cross-Reference by Term - This listing contains entries for 
all terms used within the program. 
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Cross-Reference to Equator - This listing repeats the definition 
and references to equated tags in same format as 
in the cross-reference by term. 

Source Program Listing - Shows the contents of each card read. 


Supplementary Listing - This list consists of the following 

(1) 

Diagnostic Check List 

(2) 

Unrecognized Op-Codes 

(3) 

Assembler Directing Op-Codes 

(4) 

Input-Output Type of -Codes 

(5) 

Perform Type Instruction 

(6) 

Path Terminations 

(7) 

Privileged Instructions 

(8) 

Proqram Linkage Op-Code-Entered here are 


ENTRY, EXTRN , etc. 

(9) 

User Macros and Macro Calls 

(10) 

Proqram Segmentation Op-Codes 


Listings for FORTRAN: 

Source Program Listing - Shows contents of each card. 

Flowchart - This is a two-dimentional flowchart. Flowcharts 
may be in a double-page format. 

Statement Label Cross-Reference - This listing contains all 
statement nuntiers belonging to procedural 
statements or referenced by procedural statements. 
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Data Name Cross Reference - This contains all data field 

names, subroutine names, and labels used in the program 
and lists, by card number, references made to 
those names. 

Diagnostic Check List - This provides a number of diagnostic 
printouts for those statements with error. 

Listing for COBOL : 

Source Statement Listing - Shown five digit card number used 
for card identification, plus the card contents. 

Flowchart - A detailed flowchart of the program is given. 

Cross-Reference by Term - This listing contains entries for 
data-names , procedure -names , literals, figurative 
constants. Each entry contains the term and all 
references to that term. 

Diagnostic Flow Summary - This is a graphic summary of the 
structure of the program in flowchart form. It 
contains all paragraph and section names together 
with the range of card numbers comprising each 
paragraph, their locations on the flowchart and notes 
and diagnostic pertaining to each paragraph. 

Note: All versions of the flowcharts are at the same level of detail as 
the source code. The COBOL flowchart only, gives the option of 
compressing the level of detail to achieve a higher level flowchart. 
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QUICK-DRAW is designed to select a convenient branch point 
whenever possible to end a page. 

QUICK-DRAW is second only to AUTOFLOW in its number of in- 
stallations. 



01087 V 14.01 

I LA 5. UpDATE 1 

) CALCULATE average BALANCE I 


01089 V 14.02 
******* 

♦ 02.15 * 

******* 

4 PRINTRTN 


TABLE30P 


E-22.36 


01090 V 14.03 
4 

« * 

* * 

* * 

* CP * BE 

•BWAOP 31 >N « 1 I.ONEP BE* 

* GETEN025 * 

* * 

* * 

* * 

* 


01092 
*- — -- 


!4 , 04 


e \. "WMir" 


01095 
*- — -- 


01094 V 14.05 
* 

* * I 

* * I 

* * BL I 

* BL PRINTRTN * * I 

* * I I 

* * II 

* * 02.15 I 

* PRINTRTN I 

i 1 

V 14.06 

* 

LA 5* GLNAMAO I 

-- — --* 

I 

I 

01096 V 14.07 

* * 

* * 

* * BE 

* BF PRINTRTN * * 

* * 1 

* * I 

* * 02.15 

* PRINTRTN 
I 

V 14.08 

— - — * 


LA 5/NEWACC1 


01108 V 14.15 

* 

* * 

* * 

* CP, * 

* MAS'vRK + 5? (7). * 

*ZE«nP(7) IS I1ALANCF* BF 

* ZERn n E testaff if ves* >* 

* TM£RE Ha Vk 8EEN NU* T 

* TNTPI^Ti. 1 NjjjW* 1 

* * I 

* * 1 


O-lllO V 14.16 

* * 

I MVC MASWRK*122(2)#n00 I 
I TODAYS OATF=0ATE (JF START OF I 

1 period | 

I 

0111 l V 14.17 

* 

* * 

* * 

* CP * 

* mASwRK*36<1>j * 

*NlNfP 00 nut I J P D A T F * BE 

* AVFRAGE BALANCE BF * >* 

* TFSTAFF field for * 

* CENTRAL ledger* 

* * 

* * 

* * 

* 

I 

01113 V 14, IB 


COMPL02 


01113 V 14, IB 1 

* * j 

I MVC MASWRK+124(5).MASWRK*58 I ! 
I M'H/F CURRENT [JALANCE INTO I I 
1 MVN MAS wRK+ 1 28 < 1 • . MASWRK+63 I 1 

I average balance FIELD I T 

* * I 

l 1 

TCSTATF I I 

E-04.26 E-14.14 I E-14.15 E-14.17 V 

>I< * 

01115 V 14.19 

* 

* * 

* * 

* TM * 

*MASW«K+40/X'02'* 

* IS IT A STAFF . * BZ 


♦ACCOUNT BZ TABLE4 
* BRANC‘1 


* * 
* 


IF NO*-* 
** 1 


14.31 

TABLE4 


UOATEL 


01117 _V 14 . 2g 

I MVC l.fJPAI. Nf. E»MASWRK*58 I 

I BAl. flF STAFF A/C 1 

1 MVN LUBALMC. E*4 ( 1).HASWRK*63 I 
I MOVE SIGN I 

— — — • 


01129 


14.28 


CP - LDBAINCEI5)*MASWRK*124(5) 
COMPARE CURRENT AND AV BAL 
BNL TABLE4 IF CURRFNT BALANCE 
HIGH OR EQUAL 


01131 


01129 V 14.29 

* 

* * 

* * 

* SEE ABnVE *— 

* * 

: * * 

* 

I 


14.30 


1 MVC MASWRK+l24(5> .LflBALNCE I I 

I otherwise upoatb FIELD I I 

* * I 


TABLE4 

E-14.19 E- 14 . 24 


01132 


F-14.27 E ->14.29 
E-27.l4.E-27, 24 

14751" 


LA 5, BACK 


01133 


14.32 


COMRC 


01134 


14.33 


I MVC MLTAREA2(2) ,3( 1) 

I mm 

1 MVC MLTAREA2*2(?)/0(1) 

I DO 

I PACK CALC(3>,MLTaREA2<41 
I MVO MONTH! 31.CAI C<3) 


01138 V 14.34 

* 

. • • . 

* CL I * 
•MONTH. X* 09* BNH*- 

* STRQUFST * 

* * 

* • 

* 

I 

{ . . 


01140 


14.35 


6 * 6 

6. MONTH 


SH 6/SIXH 
STC 6/MQNTH 


strquest 


3-121 


01099 


14.10 


* TXNS 
ACCOUNT 


PR 

CA 


FOR SBWA OP SUSPENSE 
HAVF ALREAOV SEEN 
IF ANY RECORD ON 
“IS MUST BE 

‘ PUT Tn THE 
ERk 


r E P THl 


2E|i s S?f .... ... 

ERRnR RECnRPS Tn B£ 
Bp SUSPENSE ACCOUNT. 
WILL GO TO F'. IF 


OTHERWISE 


CETEN025 


* CAn4A*5*C'F' * 


* WAS STAFF INTEREST* BE 
CALCULATED TnpAY BE *— 
*CQMpia IF MU BRANCH* 


* * 
* * 

* * 

* 


!<!: 


14.03 E-14.12 


01102 V 14,11 

********* ******** ********* ******* 


BAI 6/ ADMARFWD H 

H ( 29.34) ADHARFWD H 

********************************* 

I 

01103 V 14.12 

* 

<• * 

« * 

* * 

* CP * 


I 

J i 
■I I 

I I 


* RE GETEND25 * 

* * 

* - * 

• * 

* * 

* 

I 

01105 V 14.13 
******* 

* 22.34 * 

******* 
d TESTERR 


♦ ZERpP«-5<2> IS THIS* Bf 

* ! HE , Mi t .IIl.» NS F 2"*' 


* * 
* * 

* * 

* * 

* 


(NEXT COLUMN) 


i 


* MASwRK<4),5<4,7) * BE I 

*COMPARF ACCOUNT NUMBERS* >* 


TABLE3A I 

E-13.25 E-2P.08 | E-28.10 

01106 V 14.14 
* 

* * 

* * 

* CP * 

* MASWRK* 1 22 ( 2 ) , * 

- -- THIS# BnE 


BL 


*< 


01121 V 14.22 

* 

* * 

* * 

* * 

* * 

* CP * 


-* MASYRK+57(7)/ZER0P(7) * 
* BL PUTZERO * 


I 


-I 


* * 
* * 

* * 

* * 

* 

I 


I 01123 


14.23 


I MVC MASWRK*124(5),L0BALNCE I 
I OTHERWISE UPDATE FIELD ON I 
I C AR I 2 | 


° ll SU**l 4 - 24 


* 14.31 * 
******* 

B TABLE4 


CNMPLll 


* 

l< 


E-14.21 


01125 V 14.25 

* 

* * 

* * 

* * 

CP * 

* MAsWRK*57(7)/ZER0P* BnL 

m f *. a » ^ • L I * n.iP A Mn k . .*■ 


V 

-* 


* IS Af.enuNT OVERDRAWN 
* 8N|. CnMPLU2 IF NO * 

* BPAriCH * 

* * 


PUTZERO 

01127 


* * 
* 

I 


->} 


1 E-14. 


22 


14.26 


I MVC MASWRK*124(5)/ZERQP*2 I 
I OTHERWlSF PUT ZEROS IN FIELD ! 


i 


01128 V 14.27 

******* 




*MASWRK*40 . X ' 1)0 1 • 
♦STATEMENT REOUFSTED* BZ 
*BZ STATED BRANCH IF OFF*-* 


* * 
* * 

* * 

* * 

* 


ST 


taJe& 


01146 V 14.37 

******* 


*^6.19* 


***** 

STMMTRTN 


DAYRTN 


1-15.08 E-15.40 1 E-15.41 E-17,38 

* “’.39 


01147 


1 E-17. 
I 
V 


14.38 


MVC DAOFWEEK/ZEROX 
□I CA06A*5/X '401 


01149 V 14.39 

* 

* * 

* * 

* r. L i * 

*CAD6A*5#C 'A' .NO* BCR 

* STATEMENTS printed*—* 
* ToDaV BCR B.5 * J 

* * I 

* * I 

* * I 

* 5 


15;09 

onetoit 


01151 V 14.40 

* 

* * 

* * 

* CL I * BE 

*C A06A*5j C ' U ' BE*—* 

* ONeTO I T * I 

* * 

* * 

* 

I 

01153 V 14.41 
* 

* * 

* * 

* CL! * BE 

*C A06A + 5/ C • V ' BE*— * 

* TWOTOIT * I 

* * 

* • 

* 


- isai 

TWOTOIT 


(NEXT PACE) 


T * i *• 
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SAMPLE CROSS REFERENCE BY TERM 


OE/OA/T1 CROSS REFERENCE AT TERM OF SEF FIRST TITLE, ITRRT OR CtICT FDR STANDARD RACi II 




'S-m 

"ROSS REFERENCE TO EQUATES 

rhis listing repeats the definition and references to equated tags in the same format as in the CROSS REFERENCE 
BY TERM. 
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CROSS REFERENCE TO EQUA 


******4*.>**,V ************************ 

TER At DR IA(, AND INCREMENT * LINE 

* 


EOU 9 


0038 


************************************ 


cs or 


SFF FIRST T l TLE > ST ART OR CSECT FOR STANDARD 


<*******:'•.* 4 *<***************** 4 *****., ******************** 

REFERENCING line OPERAND NUMBER And op-code 

******* *-'<* 4 ** ********************************** ********** 


cksTaf 

EOU 

BKSTAF 

* 

2655 

* 















rRKSTAF 

* 

£ 


* 

$ 

0560 

1 

BNL 










AMVT :T 

ECU 

WAMVTO 

sWAMVTD 

* 

* 

A 

2659 

* 

* 

a 

1771 

1 

RE 










lsht 

ECU 

CD 

4 UA 
U/J 

•"4L. 

u-wo 

tou. 

U. II 

* 

2650 

* 











1 

MVC 



* 

0805 

1 

AP 

0812 

1 

AP 

0758 

1 

MVr. 

0761 



* 


* 

£ 

1 3CA 

1 

MVC 

1305 

1 

MVC 

1306 

1 

MVC 

1309 

1 

MVC 

4 

EOU 

14 

* 

£ 

0043 

* 

0116 

1 

RR 

0114 

1 

LM 

0064 

1 

STM 




5 

EOU 

15 

* 

£ 

0044 

* 

0065 

2 

LR 











EOU 

2 

* 

0031 

* 

* 

0102 

1 

BAL 

0109 

1 

BAL 

0112 

1 

bal 

0144 

1 

BR 


EOU 

3 

* 

0032 

* 

unreferenced 











EOU 

4 

* 

* 

0033 

* 

ft 

0108 

1 

BASE 

0111 

1 

LA 

0094 

1 

LM 

0107 

2 

BASE 


EOU 

5 

* 

0034 

* 

* 

0096 

1 

BASE 

0146 

1 

BASE 

0094 

2 

LM 





EOU 

6 

* 

0035 

* 

ft 

unreferenced 











EO'J 

7 

* 

* 

0036 

* 

ft 

unreferenced 











EOU 

8 

* 

0037 

* 

0065 

1 

LR 

0063 

2 

using 








080 

131 


01 


UNREFERENCED 

**************** **************************************** 


■PECIAL CROSS REFERENCE 


Tiis listing repeats entries from the CROSS REFERENCE BY TERM if they are one of the following: 

1 Non-Branch References to Instruction Tags. This will call attention to modified instructions, such as 
switches and also serve as a check for the "UNENTERED STATEMENT" diagnostic, where in fact, the statement 
was entered by means of a load address and a branch register. 

' Branches to Data. 


Anything unusual that we feel should be highlighted, such as ENTRY and EXTRN references. 
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SPECIAL CROSS REFERENCES FC'R 


QUICK-DRAW SAMPLE PROGRAM A-12 FOR ASSEMBLY 


******************** *************************** a a.,**,,************,,*.,*****. .*******«,********** 

TERAL OR tag AND INCREMENT * LINE * REFERENCING LINE OPERAND NUMBER AnD OP-CODE 

***********4*««**********9*****0* **&****«::,**,;• ** „:* n a******a***********«***. ******************* 

* * 

* * 

* 0072 * 

* * 0073 1 MV I 

* 0146 * 0138 3 PRTOV 

* 0153 * 0136 1 CN*RL 0138 1 PRTqV 0142 l PUT 

* * 0074 1 MV I 

* 0043 * 0116 l BR 

* 0031 * 0144 1 BR 

* * 

* 0098 * 

* * 0087 1 MV I 0090 1 MV I 


RSTIME 

LOW 

inter 


LOWSW 


♦ 1 
♦ 22 

EOU 14 
EOU 2 

♦ 1 


******************************** *«***..***• i* ******* ****** ************ ************************* 



PROGRAM SEGMENTATION OP-CODES 


Cff-125 


CSECT and START are in this section. 

SAMPLE SUPPLEMENTARY LISTING 

supplementary listings for Quick-draw sample program a-12 for assembly 


DIAGNOSTIC CHECK LIST 
PROGRAM LINKAGE 0P-C0OES 

assembler directing op-cooes 


INPUT-OUTPUT TYPE OP-CODES 


PERFORM TYPE INSTRUCTIONS 


*00146 

*00162 

*00061 

*00003 

*00023 

*00045 

*00051 

*00052 

*00060 

*00063 

:S8t£S 

*00152 

*0016 
*00 
*00 

*00169 

*00136 

*00138 

•00U2 

*00153 


ifi 


UNENTERED STATEMENT 
unentered STATEMENT 

entry bibo95 

. -FOR ACCESS By COBOL, 


SPACE 

EJECT 

SPACE 

Idl£i‘ 

SPACE 


10 


12 


LISH ADDRESSABILITY 


USING * 

liiil 

SPACE 2 

EJECT 2 

mu 

LTORG 3 

CNTRL PRINTER, sP/1 
PRTOV t A ?R V W R?^,0^§ 
PUT P^IMF^ 


immediately. 


ADDRESS of CoBqL-LInE IN CPR 

dtfpr 6evaddr»syslst, • 

prater on system logical 

IOAREAI.AlINEI, IOAREA 2 -ALINE 2 # 
WnKKA»YES# 

ltKpj|;i3Z/pSfS T D5. v es. 

c T §«,6E!,|S‘ NNEl -> 2 - 


•00162 

p 1 » u n»FU“ rl 5 -CONTROL, 

p,MOO p<fa?65^?L 5 igSf5Sc!:fIs 

*00102 

bal 

R2, PRINT 

*00109 


advS^e T i aS set up by c080 <- 

bal 

R2, PRINT * 

*00112 

bal 

R^PRlAV T CAPPE0 cOBOL U INE. 


PRINT UNDERLINE. 


&-M6 


Reference Format Listing (Source Program Listing) 

The entire source program is listed as QUICK-DRAW reads it for 
processing. 

The complete contents of each card is printed, including the card 
sequence number found in columns 73-80. In addition, a four-digit 
statement sequence number, assigned by QUICK-DRAW, is printed to 
the left of the card image. This sequence number will appear on 
the flowchart above the top left comer of the corresponding symbol. 

The heading of each page is labeled "Reference Format Listing." The 
QUICK-DRAW Release Number is printed following the last source state 
ment . 


•0044* 

*0045* 

*0046* 

*0047* 

*0048* 

*0049* 

*0050* 

*0051* 

*0052* 

*0053* 

*0054* 

*0055* 

*0056* 

*0057* 

*0058* 

*0059* 

*0060* 

*0061* 

*0062* 

*0063* 

*0064* 

*0065* 

*0066* 

*0067* 

*0068* 

*0069* 

*0070* 

*0071* 

*0072* 

*0073* 

*0074* 

*0075* 

*0076* 

*0077* 

*0078* 

*0079* 

*0080* 

*0081* 

*0082* 

*0083* 

*0084* 

*0085* 

*0086* 

*0087* 

*0088* 

*0089* 

*0090* 


IBIG= 0 
MOST = 0 
K=0 

INDEX8= 1 
J = (JH1GH- l)/8+l 
DO 54 1 = 1. J 
00 53 L= 1.8 
NTH (L)=6 

53 NTJI (L)=0 

54 WRITE (8'INDEX8,20) (NTII (M),NTJI(M),H= 1,8) 

WRITE (3,501)JHl(jH 

501 FORMAT (1H0.I4, 19H NODES SET TO ZERO.) 

INDEX7= 1 

6 READ(7'INDEX7,5)NODI,NODJ,ITIME I COST 
5 FORMAT (315.F6.0 

I RNODI -9999)7,11,7 

7 INtDEX8= (NODI — 1)/8+ 1 
REACK8’INDEX8,20) (NTII(M),NTJI(M),M= 1,8) 

INDEX8= INDEX&- 1 

M= 8— (INDEX8*8— NODI) 

NTII (M)= 1 

WRITE(8'INDEX8,20) (NTII (M), NTJI (M),M= 1,8) 

1NDEX8= (NODJ — l)/8+l 

READ (8’1NDEX8,20) (NTIJ(N),NTJJ(N),N= 1,8) 

INDEX8= INDEXil- 1 
N = 8 — (INDEX8*8 — NODJ) 

NT JJ(N)= 1 

WRITE(8'INDEX8,20) (NTIJ(N),NTJJ(N),N= 1,8) 

TC0ST = TC0ST+ COST 
MOST = MOST + ITIME 
K K + 1 

IF(N0DI -IBIG)9,9,8 

8 IBIG = NODI 

9 IFfNODJ — IBIG)6,6, 10 

10 IBiG= NODJ 
GO TO 6 

11 KLAST=K 

502 FORM E AT’ffl,36H FLAGS ALL SET FOR NODE NUMBER CHECK.) 
IRST=0 

LAST = 0 
K = IBIG 

55 INDEX8= (K — 1)/8+ 

READ(8'INDEX8.20)-(NTII(M),NTJI(M) > M= 1,8) 

M-- 8-((INDEX8- 1)*8-K) 

IF(NTII(M))12,13.!2 

12 IF NTJI(M))14,tf,14 
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Figure 1 - Sample Portion of Flowchart 
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Statement Label Cross Reference Listing 

The first colu mn of this listing .con t ains_^a 11 -Statement— numbe rs belon ging 
t o pro ce dur al statement s o r referenced by procedural statements. These 
statement numbers are listed in numeric order. In addition. Column 1 
contains the names of any subroutines referenced by the program. 

The second column l i sts the page and symbol box numbers where each_s.tate - 
ment number or subroutine ap pears on the f lo wchart . These location refer- 
ences are in the form "pp.bb lT , where pp is the flowchart page number and 
bb is the symbol box number on that page. If a statement number is un- 
defined, Column 2 contains the entry "UNDEF". If a referenced subroutine 
is not included in the source program, Column 2 contains the entry "EXTRN". 
Format statement labels will have the entry "FORMAT" in this column. 

The third colu mn^ list s all re ferences to the statement .number or__su brouti ne 
name. These references are also in the form "pp.bb". If a statement 
number is not referenced, it is so indicated. 

Each subprogram included in the source deck has its own cross-reference 
listing, beginning on a separate page. If any statement number appears 
more than once in the main program or in the same subprogram, it is flagged 
as MULTIPLY-DEFINED. 


STfryi avT f f £ £^IC t 


52 

• 

• 

01.01 

• 

♦ 

04.02 06.24 

53 

* 

* 

01.17 

• 

• 

01.15 

54 

* 

* 

01.20 

* 

* 

01.14 

55 

♦ 

* 

01.44 

* 

* 

02.09 

60 

• 

* 

04.03 

# 

* 

03.32 04.32 

63 

• 

* 

04.33 

* 

• 

04.30 

64 

• 

• 

05.02 

t 

* 

05.01 

65 

* 

* 

05.27 

♦ 

* 

05.26 

66 

• 

* 

06.05 

* 

* 

04.45 05.34 

67 

* 

* 

06.16 

0 

0 

NOT REFERENCED 

71 

* 

• 

03.18 

0 

0 

03.17 

80 

• 

* 

06.12 

• 

05.01 


05.36 


06.03 
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3.4 Data Name Cross Reference Listing 

This table contains all data field names, subroutine names, and labels 
used in the program and lists the card numbers in which references are 
made to those names or labels. 

This listing is not available from the FORTRAN compiler and offers a 
distinct advantage to programmers for debugging, maintenance an/3 doc- 
umentation purposes. Very often a quick glance through this listing 
is sufficient to detect keypunching errors or incorrect references. 

NCA P 0 R T H A N QUICK DRAW SAMPLE 

*****m*«******«**M***M*M*****M**M******M*****M**M»M*MM***** 
ft*?***.***^ CROSS REFERENCE BY CARD NUMBER 

* 00 7k 

* 


*0017 


- VVIf 

* 

*0010 

* 

* 0137 

* 

0150 

0159 

0168 

0174 

0200 




* 0108 

* 0231 

* 

0117 

0233 

0119 

0241 

0121 

0242 

0130 

0132 

0198 

0205 

0213 

* 0076 

4c 

0077 








* 0133 

* 

0169 

0201 

0205 

0226 

0231 




* 0135 

* 

0170 

0203 

0205 

0220 

0228 

0231 



* 0133 

* 

0172 

0204 

0205 

0222 

0223 

0225 

0231 


* 0134 

4t 

* 0077 

4c ' 

0170 

0202 

0205 

0220 

0221 

0227 ‘ 

0231 


* 0058 

* 

0085 

0127 

0132 






* 0056 

4> 

0087 

0121 

0129 

0132 

0152 




♦ 0057 

* 

* 0092 

* 

0083 

0121 

0122 

0126 

0132 

0151 



* 0003 

* 0194 

4t 

0019 

0201 

0046 

0049 

0052 

0084 

0085 

0101 

0161 

* 0059 

* 

0090 

0123 

0124 

0126 

0132 

0153 





Sggl FLONCHUT 


3 - 1 30 # * ,0,,n 


•U1N-9R0CESS1NC 


'96400007* 

lot NCA*T|1T 

9*61 

1-402 

| 1-01.09 

PR!S , I 

5**404 1 

J-Ol.IlJ 1-04.01 

00515 { 

04.12 

V 04.01 1 

4 ! 

k 00906 

t .... 

V S4.lt 

• • 


• MTCM-SUft • J •- 

• • 

• • 

VIS | 


lit 




430 •--AUT-nuf TO fT«-c <0*-I 
*AtC*-*»U« llTCM-SUll 


|<l : o*.oi 

03419 V * * 0*!ol" 

f 4 T£n-su* |Itch-su«) I 
> j 1-04.02 

03491 V 04,04 


uviATcneo-uu-s 


i 

1 - 


02.21-E-02.31 


•••••• 

• CO 70 • 


MlGM-IATC*-NJ*-*£ 

CC494 \ 

i 

mCH-|*TC**-N4N-4f 
J0446 i 

|* 

1 04.06 

pl-01.11 1-03.0* 

/ 04,07 

HICH-1005-404 | 

73 SU1 1 

I 1-0*. 11 1-04.17 

00491 \ 

I 04.QI 



• IATCH-SUI 


. i 




J0S01 V 04.11 

i "SD0"ii-4 ? tIoui"to*ni CM- i l5Ic t5 1 




V 04,14 


J0902 

j*;sn; : {; 5r T i j ?H H { cH T ,T.- c T, ( 

i * * i 

I >1 

oo>o* « o».n 


»T»-|«|T-»0, 


! .gvi Da-itTCM-Nux rg i 



i 04.17 


00901 

• 04.0* • 


vt$ 

• ( (NO 9 

* • * 7 i-ino( 8 !iSJ 

HO I 

00994 i 04.11 



(NKIT COLUMN) 


ft(A0-T4M-l20 





sAMHLb CROSS REFERENCE BY TERM 





- - j Until 

• T 0142-004.41 

f 



• UTftil 

4 T 0949-004.49 

I 


HlGH-mUIS 

• PIC-CON 

• S 0119-001.41 S 0361-009.12 



NUNCKIC 

• PIC-CON 

• T 0147-001.11 



• UN ------- 

- - • PIC-CON 

4 H 0469-004.22 



J*»CI 

• M6-C0N 

• S 0153-001.14 



J**CI* 

• Ptc-CON 

j ! 8291:884:12 i 8248:881:12 s 

0*70-001.01 S 09ll-001.ll S 0tl*-00«.0l . 


mo 

• MO-CON 

• T 0*21-002.1* T 0**1-001 • *2 1 

0»9*-00*. 17 . 


aios 

- - • pic-con 

• 

: i i 8MJ:U ? 

• S 0420-001.46 S 0621-001.46 T 

!lii:i!!ii! * ^l* : 83I:tl 1 8M:88?:2l | 


0 

• UTftil 

• 5 0*11-00*. 0. T 06*2-00*. 12 T 

0672-004.25 S 


oi 

• L|TI»»l 

• T 01)6-001.01 T 0160-001.0* T 

01**-001.11 T 03**-001 .10 9 


02 

• l|T»«U 

• T 0117-001.01 T 0161-001.10 T 

01*1-001.11 T 0190-001.20 . 


1 • - 

- - • UTftil 

• 

• 

• 

• 

• 

• 

: 1 Siii:iS!:JI 1 1 

: t ( iliblll:!! ! 

• 5 0I3S-006. 1 1 T 06.6-0 0 6 • 1 * T 

• f 067.-C06.2J 7 067*-006.27 t 

• t 06*6-006.16 T 06*1-006.16 7 

I W-!t i filial! i ssit 1 

1 8ISI:ii!:i! 1 Si!S:5ti:S! : 

liiiilll! i iiiiiffi:!! i filial! i 


2 

• umu 

• 

2 * 8:n:882:!2 ? S^S:§82:84 \ 

8281:882:12 f 82«:S82:I6 1 8848:582:51 2 


2) 

• until 

• T 0462-001.01 



1 

• UTftil 

: ? 8^88:882:32 ? 8388:881:91 ’ 

0*71-006.29 7 06*1-006.16 T 0**9-:0«.l* . 


4 ------- 

- - • until 

4 S 0468-002.41 T 0692-006.14 T 

0»*»-00*.l» T 0701-00*.!* T 070l-O0t.lt 2 


4« 

• unm 

• T 0610-004.04 T 0660-004.29 



9 

• UTftil 

4 T 0179-001.11 $ 0171-001.16 



90 

• until 

• 

J 1 838f:888:Ii ’ 06 “ m ” T 

0*11-006.1* T 06*1-00* • 1* T 0700.10*. 1* • 


? 

- - • UTftil 

• $ 0176-001.6T 



• 

• UNOfP |Nf 0 

4 T 0193-001.22 



ACeE>*-3*T|-J30 

• 0361-001.29 

• f 0393-002.01 



*CC|PT,nu^-t*pis-ioo 

• 0379-001.40 

• f 0402-002.11 



4Cn ------ - 

- - • UNOfP I Nf 0 

• 

: i S!!!:S!!:H ! iHHSiitt ' 1 >K ™* 1 ' wwiirii : 


AHT-40v«HY-CT« 

• 0103 

• t 0449-302.36 1 0962-009.39 S 

01*1-009. 1* • 061»-009.*l 2 


4HT-N0«»P*Y-C t * 

• 0101 

• 

• t 0424-002.25 t 0«4t-002.3) S 

• 

0911-005.17 1 0612-009.** 2 




• t 0432-002*29 S 0596-009.41 S 

0516-005 .* 1 * 0614-001.** * 


*NT.UNHAT-PAY-CT« - - 

- - • 0091 

• NOT tEPftfNCfe 

• 

4 


6 

• UNOfP 1 Nf 0 

• T 0353-001.22 

• 

• 


0*9-NU“.T*»l$-J06 

• 0394-002.0% 

• f 0363-001.41 

• 

• 


tATCH-CT«J 

• 0319 

J NOT SCHMNCfr 

4 

4 


• ATCM-OfTAU.l - - - 

- - • 0309 

J 5 0702-004.16 

4 

• 



• 0211 

• S 0472-006.25 

4 

• 


MfCH-MlAO.J 

• 0219 

• S 0479-006.23 

• 

• 


IATCH— C40-J 

• 0297 

• S 0474-006.25 

4 

• 


MTcm-SUI 

- - • Olil 

• 

• 

• K 0197-002.36 t 0)91.002.06 t 

• • $441-002.13 4 0*31 -CC2 • 1$ t 

• T 0*69-00*. 02 T 0*50-004.03 ^ 

8t82:88i:i? 5 8:25:881:12 ? 8225:281:11 2 

0501-00*. 12 ' 0502-00*. 11 t 0501-00*. 1* » 

•• 

|*Tch-T3T-40P-*00 

• 0411-003.05 

■ 

• P 0469-302.40 • 0*79-003.03 

• 

• 

• 
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SAMPLE DIAGNOSTIC FLOW SUMMARY 


E 0393 
E 0402 

E 0372 E 0367 

E 0383 

E 0480 E 0466 E 0387 
X 0554 

A 0378 E 0414 E 0370 


E 0371 A 0378 - 0409 


E 0421 


E 0372 A 0420 - 0492 
E 0401 


X 0420 £ 0429 E 0371 


E 0438 


>•* 

* 


0361 0369 


01.29 


( ACCEPT-DATf-300) 


I 


->E 0388 


>*■ 


0370 0387 


01.33 


(TEST-GO-pEP > * 

< ACCEPT-NUM-TaPES-300) * 

ALTER 0409 TO f,0 TO 0420 * 


E 0436 E 0409 E 0420 E 043 
£ 0453 E 0505 E 0509 | 038 
E 0436 i 0453 E 0495 E 050 

■>! 8!S5 f 8SI1 1 858) ' 


•>*- 


0378 RESERVED WnRD MARGIN A 
0388 0393 


I 

V 


01.47 


{ INVALID- DATE-305) 

I 


•>E ONOF E 0453 E 0361 


0390 NO LITERAL CLOSING QUOTE 
0392 UNDEFINED REFERENCE 
0392 NESTED CONDITIONAL 


->*- 


0394 0402 


02.04 


( 8 AO-NUH-TAPf S-306 > 

I 

0396 NON-ANSI CHARACTER SEQ. 


->E 0453 E 0436 E 0379 


8188 nIIIIB E8B8HI8HU 
8 


->♦- 


0403 0408 


02,12 


(GET-NEXT-01SK-REC-310) 


I 


■>’- 8182 i 811? 1 851? ’ ” 


->*- 


0409 0419 


$ 


02,17 


(MATCHE0-8IIL-320J . 
ALTER 0492 TO GO TO 0436 


l 


*>A 0378 - 0420 E 0409 


0410 STATEMENT UNALTERABLE 
0413 NESTEO L !oND?TIONAL 


0420 paragraph ends badly 


->*- 


0420 0427 


I 


02.2 


(CHECX-ZER0-320) 

(EXIT) 


I 


■>E 0428 E 0453 X 0444 


->*- 


0427 EXIT AFTER GO 
0428 0435 V 


02,28 


(CHECK-LISs-321? 


■>E 0437 E 0453 


->* 


0436 0436 


02.31 


* (TOTAL-OuT) 

* NULL PARAGRAPH 

'* — — — 

I 


0437 NO VERB IN PARAGRAPH 
0437 0445 V 02.32 


(CHECX-EQUAl-322) 


■>E 0446 P 0420 £ 0453 


->*- 


0446 0452 


02,36 


< IT-IS-GREaTeR-323) 


■>E 0453 
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SUPEREF 

Mantech Corporation 

GENERAL 

SUPEREF accepts FORTRAN coded source programs and produces a 
comprehensive symbolic name cross reference dictionary. 

SUPEREF is operational on any CDC 6000 series computer whose 
software capability has been updated to include the Random access 
(mass storage) File Routines OPENMS, STINDX, READMS, and WRITMS. 

PACKAGE OUTPUT 

Variable Name Dictionary - This listing includes the variable 
name being used, the routine that it is located in, 
and various other information. 

Note: A note of interest is that Mantech Corporation was awarded two 

contracts from the U. S. Naval Ordinance Laboratory in Silver 
Spring, Maryland to have two large-scale FORTRAN simulation programs 
processed by SUPEREF. 
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PROGRAM INTEST? (INPUT * OUTPUT , SAVFM, 

1 TAPE 5s INPUT, TAPF.ft .OUTPUT. TAPF7-SAVEM) 

COMMON NOLNf)tNOlN7tLNAL6.LNAL7»NPA<iEfc.NPAGE7 

COMMON /AHCD/ A(S) ,fl(S,2) tC(10) *0(10.2,2) ,F. 0110,4) 

OIMENSIOm E ( 10ft) 

EQUIVALENCE (F < 1 > « A ( 1 ) ) 

DIMENSION ITRTML<7,2) »I0mtHL(6,3> ,LOADR(3.3) , VALuE (3) 

DATA ITRTRL* IOMTRL 
1/1 ha 1 1HU* lMCt iHfi* 1HE* lHG.ftH) I )) H * 

2 O* 5. IS, pS. 65, 66, 106, 

35,5,10*10,1,10, 0*2,0, 2, 0*4, 0*0*0*2*0*0 / 

DATA ISM /o/ 

NOLNfccO 

NOLN7=0 

LNAL6*60 

LNAL7s60 

NPAG£6*0 

NPAGE 7*0 

CALL LlNtft (60) 

CALL L INF. 7 (60) 

5 READ (5*100) mAME 
100 EOPMAT (Aft) 

IE (NAME.EQ.6HEN0INP) GO TO 30 
DO 10 1*1,6 

IE (NAME ,E0» ITRTRL ( I t 1 ) > GO TO 15 
10 CONTINUE 

WRITE (6, poO) name 

200 FORMAT (1H0.A6.P6H IS NOT IN TRANSFER TABLE.,/, 

11H0,47HINTFST2 PROGRAM PROCESSING IS BEING TERMINATED. ) 

CALL L I NEft ( 2 ) 

STOP 

15 INCRM«ITRTHL(I,2) 

20 READ (5*300) (LOADR ( J • 1) . LOADR ( J* 2 ) tLOADR ( J. 3) , VALUE ( J) . Joi , 3) 
300 FORMAT (3(314, F10, 3) ) 

DO 25 K s 1 , 3 

IF (LOADR(K*l) .EQ.9999) GO TO 5 

IE (LOAUW |K • l ) ,EO,0) Go TO 20 

IF ( (LOADR (K, 1 ) # LE • IDMTBL ( 1 1 1 ) ) .AND. 

1 (L0A17R(K,P) ,LE. IDMtBL (1*2) ) .AND. 

2 (LOADr (K , 3) ,LP. IO m THL(I«3) ) ) GO TO 23 

WRITE (6,360) LOADRIK.l ) ,LOADR(K,p) ,LOADR(K,3) ,VALUE(K) .NAME, 

1 IDMTBL (1,1) .IDMTBL (I. 2) ,IOMTHL(I,3) 

360 FORMAT (1H ,BH«INDEX (,I4,1H,,I4,]H,,I4,4H) , VALUE ,F10.3, 

120H FOR ARRAY/vARI ABLE ,A6*1H(,I4,1H,,I4,1H,,14,]H) ) 

CALL LINL6 (1) 

ISW*1 
GO TO 25 

23 II*IOMLOC(IDmtrL(I,1) » IOmTBL ( I »2) , I DMTBL ( I *3) , 

1 L0ADP(K,1),L0A0R<K,2)*L0ADR(K»3)> ♦ INCRM 

EIII)sVALuE(K) 

WRITE (7,350) NAMF.LOAoR (K, 1 ) ,LOADR(K,2) , LOAQR (K , 3 ) .VALUE (K) 
350 FORMAT (1H *7X,A6,HX,1h(,I4,1H,,I4i1H,,I4,1H) *3X,F10.3) 

CALL LINE 7 (1) 

25 CONTINUE 
GO TO 20 

30 IF (ISW.NE.O) GO TO 35 
WRITE (6,305) 

CALL LINE ft (i, 

305 FORMAT (1H0.3RHNO DIAGNOSTICS FOR THIS RUN OF I TEST2. ) 

35 WRITE (6,500) ITRTPL ( 1 ) , A 
CALL LINE6 (2) 

WRITE (6,500) I TRTRL (2) »R ■ 

CALL LINFft(3) 

WRITE (6,500) I TBTRL (3) «C 
CALL LINE 6 (3) 

WRITE (6,500) ITRTRL (4)-,0 
CALL L INF ft (9) 

WRITE (6,500) ITRTRL (5) ,F 
CALL LlNEft (2) 

WRITE (6,500) I TRTRL (6) »G 
CALL L INF ft (9) 

500 FORMAT (1H * Aft,/, (S(F 10,3) ) 

FNOFILE 7 
CALL EXIT 
END 


IN* 

10 

In* 

20 

In* 

30 

In* 

40 

In* 

SO 

In* 

60 

In* 

70 

In* 

ao 

In* 

90 

In* 

loo 

In* 

1 1 0 

In* 

120 

In* 

130 

IN* 

140 

In* 

ISO 

IN* 

160 

In* 

170 

In* 

lao 

IN* 

190 

In* 

200 

In* 

210 

In* 

220 

In* 

230 

In* 

240 

In* 

250 

In* 

260 

IN* 

270 

In* 

280 

In* 

290 

in* 

300 

In* 

310 

In* 

320 

In* 

330 

in* 

340 

In* 

350 

In* 

360 

In* 

370 

IN* 

380 

IN* 

390 

IN* 

400 

In* 

*10 

In* 

*20 

In* 

430 

In* 

4*0 

In* 

*50 

In* 

460 

In* 

*70 

IN* 

480 

IN* 

*90 

In* 

500 

In* 

510 

In* 

520 

In* 

530 

In* 

540 

In* 

550 

IN* 

560 

In* 

570 

In* 

580 

In* 

590 

In* 

600 

In* 

610 

In* 

620 

In* 

630 

IN* 

6*0 

In* 

650 

In* 

660 

In* 

670 

In* 

680 

In* 

690 

In* 

700 

In* 

710 

In* 

720 

IN* 

730 

In* 

7*0 

In* 

750 
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THIS IS A -S U P E R E F- LISTING OF 
ILLUSTRATIVE problem 


ROUTINE FORTRAN STATEMENT 

NAME 

IMTL •*••• COMMON / ABCO / 

IMTL OATA A /5*1 .0/ 

INTEST2 •#••• COMMON / ABCO / 

INTEST2 EQUIVALENCE (ElllfAlll) 

IMEST2 35 WRITE (6.500) ITRTBL ( 1 ) »A 

IMTL COMMON / ABCO ✓ 

IMEST2 •••*• COMMON / ABCO / 

IMTL ••••# common / ABCO / 

IMTL DATA B / 1 0*2 . 0/ 

IMEST2 ••*•• common / A8CD / 

I n T £ S T 2 WRITE (6.500) ITRTBL (2) *8' 

IMTL •••*« common / ABCO / 

IMTL DATA C /1 0*3.0/ 

IMEST2 •••*• COMMON / ABCO / 

IMEST2 WRITE (6,500) ITRTBL(3).C 

IMTL •«*** COMMON / ABCO / 

IMTL OATA D /40*4.0/ 

IMEST2 ***** COMMON / ABCO / 

I M E S T 2 WHITE (6.500) ITRTBL(*).D 

INTEST2 DIMENSION EU06) 

IMEST2 EQUIVALENCE ( E ( 1 ) • A 1 1 > ) 

INTEST2 E ( 1 1 ) sVALUE (K ) 


CALL EXIT 

*•••• COMMON / ABCO / 

OATA F /5.0/ 

••••• common / ABCO / 

WRITE (6,500) ITRTBL (5) tF 


IMTL •«••• COMMON / ABCO / 

IMTL DATA 6 /4 0*6 , 0/ 

IMtST2 ***** COMMON / ABCO / 

IMEST2 WRITE (6,500) ITRT8L (6) tO 

IOMLOC FUNCTION IDMLOC (II t JJ.KK* I , J.K) 

IOMLOC IOMLCC=I*II*( J-I) *II*JJ*(K-1) 

IOMLOC 10 IOMLOC=I«II*( J-l) 

IOMLOC 20 IOMLOC=I 

IN TEST2 23 II = ICML0C(IDmTbL(I.1>.I0mTBl(I»2)»I0MT8L(I»3)» 

INTEST2 1 LOAOR (K» 1 ) , LOAQR ( K , 2) tLOADR (K.3) ) * INCRM 

IMEST? DIMENSION ITMTHL(7»2).IDMTRI (6.31 <) OAftO (1.31 • V At. UF (3 1 



PAGE 1* 


Bn* 

20 • •••• 

variable • 
name • 
• 
• 

A • 


BO* 

3 0 • • • • • 

A • 


IN* 


A • 


IN* 

6 0 • • • • • 

A • 


IN* 

600 • • • • « 



Bn* 

20 • • • • • 

ABCO • 


IN* 

♦ 0 • • • • • 

ABCO • 


Rn* 

20 • • • • • 

B • 


rd* 

4 0 • 1 1 • • 

B • 


IN* 

6 0 • • • • • 

B • 


IN* 

620 • • • • • 

B • 


BD* 

20 .... • 

C • 


Rn* 

50 • • • • • 

C • 


IN* 

4 0 • • • • • 

C • 


IN* 

64 0 • • • • • 

C • 


Bn* 

2 0 • » • • • 

D • 


Rn* 

60 • • • • • 

0 • 


IN* 

AO . 

D • 


IN* 

660 • « • • • 

0 • 


IN* 

50 • • • • » 

E • 


IN* 

60 • • • • • 

E • 


IN* 

500 • • • • » 

E • 


IN* 

740»»«»« 

EXIT • 


Bn* 

20 • • • • • 

F • 


Bn* 

70 • • • • • 

F • 


IN* 

4 0 • • • • • 

F • 


IN* 

680 

F • 


BO* 

20 • • • • • 

G • 


RD* 

80 • • • • • 

G • 

1> 

IN* 

40 • • • • • 

G • 


IN* 

700«tn« 

G • 

l 

in* 

1 0 • • • • • 

IOMLOC • 

0* 

in* 

4 0 • • • • • 

IDMLOC • 

0 

in* 

60 • • • • • 

IO«LOC • 

in* 

8 0 • • • • • 

IOMLOC • 


IN* 

480 • • • • • 

IDMLOC • 


IN* 

490 • • • • • 

IOMLOC • 


tu* 

Tft 

ihmTbi • 
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FORDOC 


J. Toellner and Associates 


GENERAL 

FORDOC accepts Fortran source program as input and produces a 
restructured source deck along with a variable name cross-reference. 
The system is composed of six modules that can be run separately or 
as an entire series. 

PACKAGE OUTPUT 

Restructured source deck - the original source deck is "cleaned 
up" by FORDOC giving an easier to read source deck. 

Cross-Reference - this listing is a variable name cross-reference 
listing references made to a given variable name. 
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SUMMARY 
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SUMMARY 

The need for adequately documented computer programs is an essential 
element common to all data processing centers. This need for documentation 
can be efficiently accomplished through the use of automatic documentation 
software packages. The use of these packages saves both time and money 
as well as establishing a standardized documentation presentation for each 
program written. 

This report has shown most of the better proprietary automatic docu- 
mentation systems along with their output features. RPG documentors have 
been excluded intentionally. 

It is evident that there is much room for improvement in this area of 
program documentation. The door is open for an automatic documentation 
system which does a better job of presenting a program structure. Better 
automatically produced flowcharts and descriptions of data structures are 
two areas in which work needs to be done to develop new modes of presen- 
tation. 

There also is a total lack of any aids to produce global or system- 
wide documentation in the software packages reviewed here. 

Perhaps through the combinations of certain features found in auto- 
matic documentation packages existing today, and by utilizing new ideas to 
supplement these features, an ideal system could be developed. 
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AUTOMATIC SYSTEM FOR COMPUTER PROGRAM DOCUMENTATION 


Working Paper No. 5 
July 14, 1972 

Documentation and Operating Systems 


by 

Andrew Sobey, Jr. 


Texas A&M University 
Texas Engineering Experiment Station 

0 - ! ^ 
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ABSTRACT 

The various options available to the user through compilers (PL/I, 
FORTRAN, and COBOL), assemblers and linkage editors/loaders are listed. 
Conclusions are then drawn as to which of these options would be useful 
in the development of an automatic documentation system. 
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INTRODUCTION 

The purpose of this paper is to describe the interaction between 
a user program and the operating system of a computer. The motivation 
for this study (also the main objective of the study) was 1.) to de- 
termine those options available to the user without modification of the 
operating system which would be of significant importance to the devel- 
opment of an automatic program documentation system and 2.) to determine 
what difficulties might be encountered at the operating system level in 
developing an automatic documentation system to be used on many different 
manufacturers' computers. As the basis for the discussion of this topic, 
the following three operating systems will be considered: 

1. IBM's 0S/360 

2. UNI VAC'S EXEC 8 

3. CDC's SCOPE 3 

To explain the medium by which this interaction takes place, and 
also the extent to which it can take place, the compiler and linkage 
editor/loader options available to the user through the control language 
for these systems will be discussed. As it would be impossible in the 
allotted time to examine all existing higher level languages and their 
compiler options (just as it would also be impossible to study all 
operating systems in existence) , the following three languages have been 
chosen for study as being representative of all higher level languages: 
PL/I, FORTRAN, and COBOL. Also, the assembler languages of the above 
mentioned three machines and their options will be considered. 
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COMP HER/ ASSEMBLER OPTIONS 


A. Option s 

The first step in the study was to compile a list of all the compiler/ 
assembler options available to the user by the operating systems for the 
four languages under consideration. These options were then studied in 
light of their possible usefulness as part of an automatic system of 
program documentation. A list of these options is indicated on the next 
several pages. It will contain an explanation of the option, and is broken 
down by manufacturer and language. 

It is urged that the reader study this list of options before proceding 
to the next section of the paper (See list on following pages). 

B. Results and Remarks 

Because one of the criteria of the study was to determine those items 
which could be obtained without modification to the operating system, let 
us consider those options which are common to FORTRAN, COBOL, and Assembler 
languages under all operating systems (PL/I is not offered on the UNIVAC 
1108 or CDC 6600 machines.) 

1. A source listing may be obtained. 

2. A cross-reference table may be obtained. 

3. The user may specify from where to read the input file. 

4. The user may specify where to write the object module. 

Thus, it can be seen that although a myriad of options are offered by the 
three computer manufacturers, only four options are common to all of them. 
These options, however, the author feels would be of significant value to 
the development of an automatic documentation system. 



TABLE I. ASSEMBLER OPTIONS 


1 — 

OPTION 

I CDC 6600 

IBM 360 

1 ijntvac nnft 1 

Specify that an assembler language 
listing is to be produced 

L=fn; place a full list- 
fing on the file named 
if n ; if L=0, put a brief 
[listing on the file 
[named OUTPUT; if absent 
fOUTPUT is assumed for 
fn 

LIST (NO) 


Specify from what file the input is 
to be read. 

I = fn; the input is 
on the file named fn; 
if absent INPUT is 
assumed for fn. 

Done through JCL 

The file name to be read 
is coded on the control 
statement. 

Specify the file the object module 
is to be written upon. 

B=fn; a binary file 
is written on the file 
named fn; if absent, 
LGO is assumed for fn; 
if B=0 is coded, the 
binary file is sup- 
pressed. 

LOAD, pace on the 
drive specified by the 
SYSGO DD statement 

The file name the ob- 
ject module is to be 
placed on is specified 
on the control state- * 
ment 

| Specify where to search to find 
the systems text. 

' 



if absent, or S, the 
systems text is on 
SYSTEXT(SC0PE Central 
Processor Macros) 
S=rname; the systems 
text is on the over- 
lay named rname. 
S=SCPTEXT ; the systems 
text if from the 
library overlay named 
SCPTEXT which contain: 
the system symbol j 

definitions 1 

S=SMTEXT ; systems text 
for SORT/MERGE macros 
plus SCPTEX macros 

Done through JCL 

! 

. 




IBM 


360 


UNIVAC 


1108 




DECK(NO) 

r 

p ' 1 

TEST (NO) ; the object 
module contains the 
special source symbol 
table required by the 
test translator 
(TESTRAN) routine and 
the TSO command 
I processor 


XREF (NO) 

} l 

L 

r 

RENT (NO) 


LINECNT=xx; where xx i< 
the number of lines 
i desired. 


r ' 

u 

| 











Specify numbers are to be written 
in the beginning of each line for 
which diagnostic information is 
gi ven 

i 


Specify that statement numbers 
are to be supplied for statements 
for which diagnostic information is 
gi ven 

Specify that the run is to be 
continued even though errors have 
been detected 


Specify that the run is to take the) 
error exit if errors are detected 




TERM(NO) ; write the 
diagnostic messages 
on the SYSTERM data 
set 


NUM(NO); the line 
number field (cols 73- 
80) or TSO through 
the EDIT command 
supply these numbers; 
this option is only 
valid with TERM above 


STMT(NO); these number- 
will be written on the 
SYSTERM data set; this 
option is only valid 
with 'TERM' above 


Done through JCL 



Done through JCL 


A; this option need 
not be specified as 
it is always in effect 
unless overridden by 
the X option 


X; overrides the A 
option above 







OPTION 

CDC 6600 

IBM 360 

| _UNj VAC 1108 ! 

Indicate the relocatable is output 
code is quarter-word sensitive. 



f i 

Specify compressed card input in 
columns 1 through 80 




Specify that input cards have 
sequence numbers in columns 73-80 



H; these numbers are 
ignored unless the K 
option (below) is 
specified 

Specify compressed card input in 
'columns 1-72 and sequence numbers 
fin column 73-80. 

S 



J 

i 

ij Specify a sequence check is to be 
| performed when reading the input 
cards (columns 73-80) 


• 

K; used in conjunction 
with the H or J option 
above 

Specify the assembler's internal 
symbol table and procedure 
sample table areas are to be 
expanded 



M; expanded by an 
additional 10240 words 
when used with the R 
option these areas are 
expanded by only 5120 
words 

Specify all listings are to be 
suppressed 


N0LIST 

N; or omit all listing 
parameters 

Specify a machine language listing 
is to be produced 



0; done in octal 
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OPTION 

Specify the source language 
output should be in Fi el data code 


Specify the ASCII character set is 
to be used 


Specify that the amount of core 
storage is to be lessened for the 
internal tables 


Specify that the relocable output 
code is third-word sensitive 


{Specify an update is to be made of 
|an existing source language input 
{element to the next higher element 
cycle 


i 

j— 

Specify the correction lines 
are to be listed at the head of 
the printer listing 

Specify the name and version of 


the source element 


Q 


R; 5120 words are 
dropped from the 
assemblers: internal 
symbol and procedure 
sample table 

T; (is overridden by 
the F option) 


U; the 'eltnames' 
parameter on the 
control statement must 
be coded; the updated 
version has the same 
name as before but 
the cycle number is 
increased by one 

W 


Nl/Vl ; where N1 is 
the element name and 
VI in the version 
number 


0 

1 

vo 








OPTION 

CDC 6600 

TRM , fin 

|jJ.NLLVAC_„„„„.„-.noa __ . 

Specify the name and version of an 
updated source language module, 
id, where to place the updated 
module 


Done through JCL 

N2/V2; where N2 is 
the element name and 
V2 is the version num- 
ber 

Specify the name and version of 
the updated object module, ie, 
where to store it 


Done through JCL 

N3/V3; where N3 is the 
element name and V3 
is the version number 

Specify that corrections are to be 
noted on the listing 



C 

Specify alternate Assembler is to 
be used 



J 

Specify a set of system symbol 
definitions are to be provided to 
the assembler before the assembler 
source code 



M 

Specify comments are to be inserted 
in the source or object module 



K 

Specify no listing is desired 



N 

Specify the output punched is in 
multiple word octal format 



Q 

Specify an updated output source 
language element is to be punched 
on cards 



S 

jspecify the correction deck is to | 
be listed prior to the assembler 
Jlisting 
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OPTION 


Suppress formation of information 
normally given to the diagnostic 
routine 





TABLE II. FORTRAN OPTIONS 


OPTION 

| CDC 6600 

IBM 360 

UN I VAC 1108 I 

Specify that a machine language 
listing of the compiled program is 
to be produced 

0; in octal 



Specify that a source listing of the 
program to be compiled is to be 
produced 

L 

SOURCE (NO) 

EDIT (NO) ; produces 
structured listing 

I ; single spaced list- 
ing 

L; detailed listing 
M; double spaced 
listing 

N; produce no listina 

Cross Reference Table-Showing 
where the variables were defined 
and where they were referenced 

R 

XREF(NO) 

L 

List All diagnostics indicating 
all non-ASA usage 

X 



Specify an assembler-language 
jli sting is to be produced 


LIST(NO) 

L 

jTells on which file to write the 
{output 

l=fn; 1 is the type of 
listing desired (one 
of the above four); 
fn is the file name 
which is to be written 
upon 

Done through JCL 

Done through control 
statement 

•Indicate from what file the source 
{program is to be read • 

I=fn; fn tells which 
file is to be read fron 

Done through JCL 

Done through the Con-, 
trol Statement 

1 
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OPTION 


CDC 


6600 


Indicate where to write the machine 
language file of the compiled 
program 


Provide and error trace back and 
calling sequence 


B=fn; a binary relocat- 
able file is to be 
written on the file- 
name fn 

E-the object code is 
prepared for EDITSYM- 
this facilitates hand 
optimization of the 
compiled code 

T 




permits the programmer to name his 
'main program routine 


Indicate the maximum number of 
lines to be written on a page of 
the source listing 


Indicate an object module is to be 
punched 


(Include a table of named variables, 
[their type and location.and a table 
of labels 


IBM 


360 


UN I VAC 


1108 


y— 

LOAD; write the object 
module on the data set 
specified by the 
SYSLIN DD statement 

Done through the 
control statement 

ID; also, internal 
statement numbers are 
generated for state- 
ments that call a 
subroutine or contain 
an exteranl function 
references (four extra 
bytes are needed for 
linkaqe) 

Done by 'SNOOPY' 

NAME = xxxxxx; where 
xxxxxx is a six 
character name conform- 
ing to FORTRAN rules 
of variable names 

. 

LINECNT=XX; where xx 
is the number of lines 
desi red 


DECK(NO) 

P 

MAP(NO) 

_ 


C-13 






OPTION 

CDC 6600 

IBM 360 


Indicate which character set the 
compiler should accept 


BCD or EBCDIC 


Indicate to what degree the compile) 
is to optimize the coding produced 

. 1 


0PT=0; no optimization 
0PT=1 ; each source 
module is treated 
as a single 
program loop each 
loop is optimized 
with regard to 
register allocatior 
and branching 
0PT=2; the compiler 
treats each source 
module as a 
collection of 
program loops and 
optimize each loop 
with regard to 
• register allocatior 
branching, common 
expression, 
elimination, and 
replacement of 
redundant comp- 
utations 

9 

Indicate the amount of main 
storage available to the compiler 


Size=nnnnk; where 
nnnn is between 115 
and 9999 


Specify that a listing indicating 
[the loop structure and the logical 
(continuity of the program is to be 
IproducecL. 


EDIT; A SYSPRINT DD 
statement must be 
included, and 0PT=2 

must also hp specified. 
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OPTION 


CDC 


Specify whether or not the output 
from the compiler is to be accepted 
if an error has been detected 

Specify inline double precision 
coding is to be generated 

Specify the labeled comtion is to 
be attached to only those segments 
which use it 

Specify the alternate FORTRAN 
compiler is to be used 

Specify an updated source 
module is to be punched 

Specify the time of each phase and 
the total compilation time is to 
be printed 


Specify that the correction deck is 
to be listed prior to the compila- 
tion listing 

Specify patch cards are to be used 
to alter the compiler operation. 


Specify that the formation of 
information normally given to the 
diagnostic- routine is to be sup- 


IBM 


360 


UN I VAC 


1 


Done through JCL 



iU^ 


A; accept it 













OPTION 

CDC 6600 

I IBM 360 

luNIVAC 1108 

Specify what source element is to 
be updated 


Done through JCL 

Nl/Vl; when N1 is the 
source element name ant 
V2 is the version num- 
ber 

Specify an updated source element 
is to be stored 


Done through JCL 

N2/V2; where N2 
is the source element 
name and V2 is the 
version number 

Specify where to store a relocatable 
object module 


Done through JCL 

N3/V3; where N3 is 
the source element 
name and V3 is the 
version number 
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TABLE III. COBOL OPTIONS 


OPTION 

CDC 6600 

IBM 360 

""■■■■ 

UNIVAC 1108 

Indicate that the source module is 
to be listed 

L 

SOURCE (NO) 

I ; single spaced 
listing 

L; includes items 
specified by C,D 
and 0 options 

List all diagnostics indicating 
non-ASA usage 

X 



Indicate that items copies from 
the library are to be listed 

C 



Indicate that a cross reference 
table is to be produced 

R; lists cross 
reference pointers to 
source lines 

XREF; lists data names 
and procedure names 

R; lists data names 
and file names 

Indicate that the object module is 
to be listed 

0; listed in octal 

PMAP; listed in 
hexidecimal also lists 
register assignments, 
global tables, and 
literal pools 

0; listed in octal 

Indicate where to write the file 
containing the last output 

l=fn; where 1 is L or 
any combination of L 
with X,C,R,0,M (see 
above) and fn is the 
file name on which 
the output is to be 
wri tten 

Done through JCL 
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! OPTION 


jmAC~—_-U Q8.™ . 

Indicate from what file the source 
program is to be read 

I=fn; where fn is the 
filename to be 
read 

Done through JCL 

Done through the 
control statement 

! Indicate on what file to write the 
object module 

! B=fn; write the 
j relocatable binary 
file named fn; 

B=0 suppresses the 
writinq of this file 

LOAD; place the object 
module on mass storage 
or a tape volume 

Done through Control 
Statement 

Indicate on what file the COBOL 
library is located 

S=fn; fn is the file 
on which the COBOL 
library is located; 
needed only if fn is 
not COL IB 

Done through JCL 


| Suppress all DATA DIVISION binary 
output except from the WORKING 
STORAGE SECTION and CONSTANT 
i SECTION for a subcompiled program 
j which would duplicate output from 
a separately combined main program- 
iithis enables them to be properly 
! loaded toqether 

SUB 



Separate the overlay segments 
from the main programs so that 
| separately compiled programs can 
5 be loaded properly 

0B=fn; the overlay 
segments are written 
on the file named fn 


■ — 

[Specify the amount of main storage 
available for compilation 


SIZE=yyyyyyy ; is 
measured in bytes 

* 

Specify the amount of storage 
j allocated for buffers 


BUF=yyyyyy. measured 
i n bytes ; i f BUF and 
SIZE are both specifie 

'• | 
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the amount of storage 
in BUF is included in 
SIZE 

CLIST (NO) : the procedure 


portion of the listing 
will contain generated 
card numbers, verb 
references and the 
location of the first 
generated instruction 
for each verb 


DMAP(NO) 


DECK(NO) 


SEQ(NO) 


r 

S; 


LINECNT=xx; where xx 
is the number of lines 
desi red 


FLAGN ; list all 
warning and diagnostic 
messages 

FLAGE; list all but 
the warning messages 










OPTION 

CDC 6600 

IBM 360 1 UNI VAC JlQSu — [ 

Indicate the object code listing, 
object module and link edit decks 
are to be suppressed if an E level 
error message is generated by the 
compiler 


SUPMAP(NO) 

• 

i 

Indicate the type of spacing 
desired on the source listing 


SPACE! ; single space 
SPACE2; double space 
SPACE3; triple space 

• 

Indicate what kind of movement of 
computational fields is desired 


TRUNC; if the number 
of digits in the sendir 
field is greater than 
the number of digits ir 
the receiving field, tl 
arithmetic item is 
truncated to the number 
of digits specified 
in the PICTURE clause 
of the receiving field 
N0TRUNC;the movement 
of the item depends on 
the size of the 
| receiving field 
(fullword, halfword) 

g 

e 

Indicate which character should 
be accepted to delineate literals 
and to be used in the generation 
of figurative constants 

s 


QUOTE; (") is the 
acceptable character 
APOST; (') is the 
acceptable character 


jj 

I Specify the output from the 
1 compiler is to be accepted 
seven if errors are detected 


Done through JCL 

A 

_ 
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OPTION 


Specify that the checking of 
punched card sequence numbers 
(columns! -6) is to be ignored 


Specify the matched names of 
CORRESPONDING data names are to be 
listed 


Specify an alphabetic list of all 
data names and file names is to be 
printed 


jjSpecify a detailed list of 
^diagnostics is to be printed 

» 


•Specify the alternate COBOL compiler 
is to be called 


ify that a 1 
ested throug 
UDE verbs is 


Specify a list of procedure - 
jjnames with the same first five 
characters is to be produced 


Specify that the source listing 
is to contain only those items 
requested by options 


Specify the updated module is to 
be punched on cards 



N ; if absent E, I, and 
K are assumed f 
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OPTION 

CDC 6600 | 

IBM SfiO ...... 

UN T VAC LIQB 

Specify that the label will consist 
of the first five characters 
preceded by one element - specified 
unique character 


....... 

T 

| 

. 

Specify that the contents of 
columns 72-80 are to be ignored 



U 

Specify that the compiler has 
encountered a subprogram rather 
than a main program 



V; the generation 
of a starting address 
is suppressed 

[Specify that the correction deck 
jis to be listed before the 
compilation listing 



W 

liSpecify the run is to be aborted if 
jan error is found 


Done through JCL 

X 

Specify that the formation of 
information normally given to the 
diagnostic routine is to be 
^suppressed 



z 



Specify the name and version 
of the source element 


Done through JCL 

Nl/Vl; where N1 is the 
name of the source 
element and VI is the 
version number 

Specify the name and version of an 
updated source language module, ie. 
where to store it 


Done through JCL 

N2/V2; where N2 is 
the name of the 
module and V2 is the 
version number 
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OPTION 


CDC 


6600 


110 . 8 ™ 


Done through JCL 


N3/V3 where N3 is j 
the object module namef 
and V3 is the version I 
: number j 





TABLE IV PL/I OPTIONS 


OPTION 

CDC 6600 "1 

IBM 360 j 

UflS 

Specify the amount of main storage 
available for compilation 


SIZE=yyyyyy ; indicates 
yyyyyy bytes of storage 
are available 
SIZE=yyyK; indicates 
yyyK bytes of storage 
are available 
SIZE=999999 ; instructs 
the compiler to obtain 
as much main storage 
as it can 

' 

' 

• 

Specify the type of compiler 
optimization desired 

■ 


0PT=0; keep object 
program storage 
requirements to a 
minimum at the expense 
of execution time 
0PT=1 ; causes object 
program execution 
time to be reduced at 
the expense of storage 
0PT=2;includes 0PT=1 , 
but also requests the 
compiler to optimize 
j the machine instructor 
I generated for certain 
DO-loops and expressioi 
in subscript lines 

1" 

is 

IS 

( 

i f 

Request the compiler to produce 
jadditional instructions that 
Swill allow statement numbers from 
Sthe source program to be included 
Sin diagnostic messages produced 
1 during execution of the compiled 

— 


STKT(NO) 

: 
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OPTION 


CDC 


6600 


Permit the programmer to name the 
load module that will be created by 
the linkage editor 

. 


Permit the operating system to 
properly handle interrupts on the 
IBM models 91 and 195 


Cause the compiler to construct 
larger dictionaries 


Specify the condition for terminatic 
after syntax checking if errors 
are detected 

n 

Specify that the preprocessor | 

is to be used 
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OPTION 

CDC 6600 1 IBM 360 

) mVA£_ 1JM 

Specify the compiler is to 
immediately compile the source 
module produced by the preprocessor 


COMP (NO) 


Specify the output from the 
preprocessor is wanted in the form 
of a card deck 


MACDCK(NO) 


Specify whether the source state- 
ments are written in the 48 or 
60 character set 

I 


CHAR60; written in the 
60 character set 
CHAR48; written in the 
48 character set (the 
compiler will accept 
both if CHAR48 is 
coded, however) 


|Specify whether the EBCDIC or 
iiBCD character sets is to be 
{accepted 

* 

- ■ ........ 

EBCDIC; BCD 


Specify the extent of the part 
of each input record that contains 
PL/I source statements. It can 
also specify the position of the 
ANS carriage control character 
desired to control the format of 
the listing produced 

L 


S0RMGIN=(mmm,nnn [ ,ccc] 1 
where: 

mmm is the first byte 
of the field that 
contains the source 
statements nnn is the 
last byte of the 
source statement field 
ccc is the byte 
containing the carriagi 
control character and 
mmm < nnn <100 and 
ccc < mmm or ccc > 
nnn 

• 

• 
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OPTION 


Specify where to place the object 
module produced 


Specify that a card deck is to be 
produced of the object module 


Specify the number of lines to be 
printed on a page of the source 
listing 


Specify that a listing of the 
source statements input to the 
preprocessor is to be produced 


Specify that a listing of the 
source statements processed by 
the compiler is to be produced 


Specify that for each statement 
of a DO-group, the block and 
nesting level should be indicated 
on the source listing 


LOAD; place the object 
module on the SYSLIN 
data set 


DECK; columns 73-76 
contain a code to 
identify the object 
module and columns 
77-80 contain a 4 digit 
serial number 


LINECNT=XX; where xx 
is the number of 
lines desired 


OPLIST(NO) 


S0URCE2(N0) 


SOURCE(NO) ; the 
statements are either 
the original source 
statement or the 
output from the 
preprocessor 


NEST(NO) 
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OPTION 


Specify that a table of source 
program identifiers and their 
attributes should be produced 


Specify that a cross-reference 
table is to be produced 


(Specify that the source listing 
should contain the ESD 


Specify that a list of the 
machine instructions generated 
by the compiler is to be produced 


Specify the minimum level of 
severity that requires a 
diagnostic message to be printed 


Specify that a formatted listing 
of the compiler modules, compiler 
storage, and compiler control 
blocks is to be produced if an 
unrecoverable error is encountered 




* 1^ 0 - 


IBM 

ATR(NO); also an 
aggregate length table, 
giving the length in 
bytes of all major 
structured an non- 
structured arrays will 
be produced 

XREF(NO); if ATR(above) 
and XREF are both 
specified, the table is 
combined 

EXTREF(NO) 


LIST(NO) ; the list is 
similar to SYSTEM/360 
assembler language 
instructions 

FLAGW; list all 
diagnostic messages 
FLAGE; list all but 
warning messages 
FLAGS; list only 
'severe' and 'term- 
ination' messages 

DUMP 
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The author would now like to list those options provided by any/all 
of the systems which he feels would be of use to the development of an 
automatic documentation system. 

1. A source listing 

2. An object listing 

3. A cross-reference table 

4. Specify the input source/object file 

5. Specify the output source/ object file 

6. Permit the progranmer to name his main program module 

7. A table of named variables including, their type and location 

8. A table of label names 

9. An indication of what character set is to be accepted (BCD, EBCDIC, 
ASCII, FIELDATA, etc.) 

10. A listing indicating the loop structure and the logical continuity 
of the program 

11. Specify if an alternate version of a compiler is to be used 

12. An indication of the time of compilation, execution, etc. 

13. An updated source/object was produced 

14. An indication of all non-ASA standard usage 

15. An indication of those modules which were subcompiled 

16. An indication of the main storage and buffer size 

17. An indication of which segments are overlays, which segments 
they can overlay, and the "path" of the overlay 

18. Specify what kind of computational field movement was used 

19. Indicate whether the quote (") or the apostrophe (') is to be 
accepted 
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20. Indicate what level /capability of compiler/assembler is needed 

21. Specify that internal table space have been increased/decreased 

22. Specify if the preprocessor was used and a listing of the 
generated code 

23. Indicate what portion of the card contained the source statements 

LINKAGE EDITOR/LOADER OPTIONS 

A. Options 

The second step of the study was to compile a list of the linkage editor/ 
loader options available to the user. (The author regrets that at this 
time insufficient information could be obtained for the CDC 6600 and UNIVAC 
1108 loaders.) These options were then studied in light of their possible 
usefulness as part of an automatic system of program documentation. A list 
of the IBM linkage editor/loader options follows. 

Linkage Editor Options 

1. Downward Compatible - makes the load module processable by either the 
level E or level F linkage editor - it lets the level E reprocess load 
modules produced by the level F linkage editor (some differences 
between the levels E and F linkage editors are: the size of main storage 
used, the number of entries permitted in the ESD or the RLD, the number 
of segments allowed, the maximum blocking factor allowed). 

2. Hieararchv Format - the programmer can specify his program to be loaded 
into either processor storage (hieararchy 0) or IBM 2361 core 
storage (hieararchy 1) - the program can be block or scatter loaded in 


either area. 
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3. Not Editable - a module with this attribute has no ESD and 
can't be reprocessed by the linkage editor. Because no ESD is 
produced, less space is needed. It is used primarily by the control 
program. 

4. Only Loadable - modules with this attribute can only be brought 
into core using the LOAD macro - this is done because some subsets 
of the control program use a smaller control table when a load 
module is invoked with the LOAD macro, thereby requiring a smaller 
storage area. It must be entered by a CALL or branch instruction - 
this attribute is used mainly by the control program and it is 
suggested that the programmer not use this option because it can 
impair the usability of a module. 

5. Overlay Attribute - is structured according to OVERLAY control 
statements - overlay modules can only be blocked-loaded, are not 
refreshable, are not reenterable, are not serially reusable, and 
cannot be assigned a storage hierarchy. 

6. Reusability - this means that the same copy of a load module can be 
used by more than one task, either concurrently or one at a time. 

a. re-enterable - can be executed by more than one task at a time - 
this module can't be modified by itself or any other coding during 
execution. 

b. serially reusable -can be executed by only one task at a time - 
this type of module must initialize itself or restore any 
instructions modified during previous execution. 

7. Refreshable - can be replaced by a new copy during execution by a 
recovery rearrangement routine without changing either the sequence 
or results of processing. 



Scatter Format - does not need to be loaded in a contiguous block of 
storage - the programmer specifies the dynamic loading of control 
sections into noncontiguous or scattered areas within his assigned 
main storage. The control program can determine a scatter format 
but for best results the programmer should specify his own control 
sections which are to be scatter loaded. 

Test - a module is to be tested and has the symbol tables needed by the 
test translator (TESTRAN) or the TSO TEST command processor. 

Exclusive Call - the link editor marks the output module as executable 
when valid exclusive references have been made between segments 
(However, a warning message is also issued) - the OVERLAY option 
must also be specified. 

LET - when specified, the linkage editor marks a module as executable 
even though it has found a severity 2 error condition - (example: 
unresolved external references, valid or invalid exclusive calls 
requested by an overlay program, an error on a link-edit control 
statement, a library module can't be found, or there is no more space 
in the directory of the output module library). 

No Automatic Library Call - the linkage editor does not call library 
members to resolve external references, and the output module is 
still marked as executable (provided no other errors exist) 

SIZE - Specifies the amount of storage to be used by the level F 
linkage editor - this option also can be used to specify how much 
storage is to be used as the load module/ text buffer(used to house 
input/output data). 

DCBS - lets the user specify the block size for the SYSLMOD data set 
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in the DCB of a DD statement. SYSLMOD is a DD statement which 
describes an output module library. It is a partitioned data set 
on a DASD and has a member name. 

15. LIST - lists the control statements processed by the linkage editor 
on the diagnostic output data set. 

16. Module Map - produces a module map on the diagnostic output data set. 

17. Cross-reference table - produces a cross-reference table on the diagnostic 
output data set. 

18. Alternate Output or SYSTERM Option - produces the linkage editor error/ 
warning messages on the SYSTERM data set; 

Loader Options 

1. MAP - same as 16 above. 

2. RES - an automatic search of the link pack area queue is to be made. 

3. CALL - an automatic search of the SYSLIB data set will be made. 

4. LET - same as 11 above. 

5. SIZE - same as 13 above. 

6. EP = name - specifies the external name assigned to the entry point 
of the loaded program. 

7. NAME = name - specifies the name to be used to identify the loaded 
program to the system. 

8. PRINT - write informational and diagnostic messages on the SYSLOUT data set. 
B. Results and Remarks 

All of the above mentioned options would provide useful information 
to the user. Thus, the author feels that they should all be included in 
an automatic documentation system. 



CONCLUSION 


In conclusion, we can see that even though the three general 
operating systems (IBM, CDC, Uni vac) reviewed in this report offered 
a myriad of options, only a few of them are common. However, this does 
not seem to be a hindrance because the individual compilers, assemblers 
and linkage-editors/loaders build tables and produce outputs which 
provide much valuable information for automatic documentation. 

At the present time, the operating systems have not been studied 
to a sufficient depth to determine if any additional information for 
documentation can be derived from other operating system components. 

It is hoped that further investigation will also reveal if modification 
to the operating systems will be necessary to obtain this data. 
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ABSTRACT 


A technique for documenting programs by means of an audio 
recording is proposed. 

An experiment designed to test the effectiveness of the 
technique was conducted. The results of this experiment indicate 
that in some circumstances programmers can use audio documentation 
as effectively as more conventional forms of documentation. 

In general, audio documentation is far easier and cheaper 


to prepare. 



INTRODUCTION 


Even though the importance and value of proper documentation 
have been extensively discussed, most computer programs are not adequately 
documented. Since the value of documentation is virtually unquestioned 
and its utilization is so inconsistent, then perhaps an alternative to 
the conventional documentation package needs to be developed. The 
purpose of this paper is to present an alternative and to evaluate its 
effectiveness. 

The technique proposed makes use of audio tapes for storing the 
majority of the documentation for a specific program. An experiment 
was designed to test the utility of this for program maintenance 
as compared to more conventional forms of documentation. 
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A STANDARD FOR AUDIO DOCUMENTATION 

The audio documentation package developed for this experiment 
contains the following four items: 

(1) Cover Sheet 

(2) Audio Tape 

(3) File Information Sheet (if required) 

(4) Program Listing. 

The cover sheet (fig. 1, p. 3) is a table of contents to the audio 
tape. The first section provides general information usch as program 
name, programmer, source language, date, tape speed and type of 
tape. The second section provides the table of contents for the tape. 
One of the major disadvantages of the audio technique is the difficulty 
in finding the desired information. The table of contents is designed 
to alleviate this problem. For the major components of the program, 
the table of contents provides: line number of the program listing, 
paragraph or routine name, and a footage meter reading indicating where 
on the tape the detailed comments for the particular section may be 
found. If the programmer desires to listen to a particular portion of 
the tape, he can then use either the fast forward or fast rewind to 
position the tape to the desired location. 

As can be seen from the table of contents, the tape is composed 
of two main sections or parts. The first should always contain the 
following sections: (1) Identification, (2) Overview and I/O, (3) General 
Flow, and (4) Symbols and Variables. The second major section contains 



the detailed descriptions of small segments of the program. 

The Identification section always begins by stating the program 
name. This requirement is imposed for two reasons; (1) To insure the 
tape has not been mislabeled, and (2) To allow meter synchronization. 

The Overview and I/O section includes such items as source 
language, system or application, entry and exit points, external refer- 
ences, tables, description of input and output, special register 
usage, etc. 

The General Flow section could be considered a verbal flowchart 
depicting the gross logic of the program. This section describes the 
major segments of the program and provides the general purpose or 
function of each major program paragraph or subroutine and indicates 
the order in which segments are performed or called. 

The Symbols and Variables section is self explanatory. Sequentially 
following the program listing each symbol or variable is named, its 
line number given and its purpose or usage described. 

The most important advantage of audio documentation is provided 
by the remainder of the tape wherein a detailed description is provided 
for each paragraph or subsection of the program. The advantage is that 
much more detail can be presented on the tape than would normally be 
provided by any of the more conventional forms of documentation. 



D-5 


AUDIO DOCUMENTATION UNIT 

Program Name Revision Date 

Yr 

0 12 3 4 5 

Programmer Phone 


/ 

Address 


Tape Speed Total Length Tape Format 

1-7/8 3-3/4 7-1/2 fl I N 3" Reel 5" Reel 

Table of Contents 


1. Program Identification 

2. Program Overview and Input/Output 

3. Segmentation and General Flow 

4. Glossary 

5. Description of Program Segment Logic 

a. 

b. 

c. . 

d. 

e. ' 

f. 

g- 

h. 

i . 

j- 

k. 


Mo Day 


Cassette 

Meter 

Reading 


Figure 1 


Audio Documentation Cover Sheet 
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AN EXPERIMENT 

As previously stated, the purpose of this experiment was to test 
the utility of this form of documentation program maintenance compared 
to those of the more conventional forms of documentation. One of the 
first decisions that had to be made was to determine which programming 
language should be used for the experiment. Since the purpose of the 
experiment was to evaluate two different types of program documentation, 
most of the higher level languages were elminated because, to a certain 
extent, they are all self-documenting. Assembly language was therefore 
chosen. 

The next decision was to limit the programs to between 250 to 350 
lines of code. This was made for several reasons, the most important 
being that a more difficult program would have placed an unreasonable 
burden on the volunteer test subjects. 

Another decision was to determine how well the two programs 
should be "commented." Any well -developed set of standards for a 
program documentation package would require that the program listing 
be well commented, especially if it were written in assembly language. 
However, a decision was made to include no comments within the source 
code. This decision was made for two major reasons. The first was 
that the experiment was being designed to evaluate program maintenance 
time of audio documentation against the more conventional forms of 
documentation (mainly flowcharts), and any comments contained in the 
source listing itself could bias the results. The second reason was 
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more of a qualitative one. If the two programs were to be partially 
"commented," then the questions arose as to which parts should be 
"commented" and the level of detail. 

A summary of how the experiment was conducted is presented below. 

(1) Two programs were selected. The programs were S/360 
assembler programs about 300 statements in length. 

(2) For each program an audio documentation package was 
prepared and a more conventional documentation package 
consisting of a textual description, flow charts, etc., 
was also prepared. 

(3) 12 Programmers were selected and randomly divided into two 
groups, 1 and 2. 

(4) Programming group 1 was given the audio documentation 
package for program A, and the conventional documentation 
package for program B, Group 2 was given the conventional 
package for program A, and the audio documentation package 
for program B. 

(5) Each programmer was asked to work independently and, using 
only the documentation provided, make a specified change to 
each program. The programming time required to make the 
change using audio documentation and the time required to 
make the change using conventional documentation were then 
determined. 

(6) An Aspin-Welch t-test analysis was then performed to 
determine if there were significant differences between the 
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times . 

The experiment's original scope was quite narrow in that it was 
limited to comparing only the average time required to make changes 
to a program using audio documentation and the average time required 
to make the same changes using standard documentation. 

No attempt was made to compare the total amount of time required 
to prepare the respective types of documentation, although the audio 
documentation is easier to prepare and takes much less time to produce. 
No attempt was made to perform any type of qualitative evaluation of 
whether the documentation did meet the established guidelines. 
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ANALYSIS 


When the programmers had completed their changes and the totals 
calculated as shown on the following page, it was readily apparent 
that the results were either contradictory or inconclusive. For 
program "A", the average time of the programmers who had used 
conventional documentation was less, but for program "B", the 
average time of the programmers who had used audio documentation 
was the shorter. When the two programs were compared, "B" had the 
lower average time, and when totals were run by tapes of documentation, 
the audio packages had the lower average time. 

Thus, it was decided to make four tests. The first two tested 
the average time of audio documentation versus conventional documentation 
for the two programs separately. For these, a two- tail test at the 
0.05 level of significance, was conducted. The third test compared 
the two programs themselves, i.e. the average time required to change 
program "A" vs. the average time to change program "B". This was again 
a two-tail test; however, it was at the 0.1 level of significance. 

A larger than usual risk of making a Type I error could be accepted 
for this test in order to reduce the risk of making a Type II error. 

This risk needed to be reduced because test four should not have 
been conducted unless the hypothesis of test three was accepted. 

Test four compared the overall average time to make the changes to 
both programs using audio documentation vs. the overall average time 



Times Required to Make Changes 


Program "A 11 Program “B" 


Programmer 

Audio 

Conventional 

Audi o 

Conventional 

1 

59 



72 

2 


43 

34 


3 


35 

20 


4 

39 



55 

5 

67 



34 

6 


42 

40 


7 


39 

38 


8 

43 



37 

9 

54 



68 

10 


42 

29 


11 


35 

36 


12 

33 



22 

TOTALS: 

295 

236 

197 

288 


531 


485 


Total "Audio" Time: 295 + 197 = 492 

Total "Conventional" Time: 236 + 288 = 524 


Table 1. Times (in minutes) required to make changes to two programs 
12 programmers using different types of documentation 
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using conventional documentation. Obviously, the validity of this 
test could be subjected to severe criticism if test three indicated 
a significant amount of difference between the two programs. The 
fourth test was two-tail test at the Q.Q5 level of significance. None 
of the tests turned out to be statistically significant. 
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OBSERVATIONS & CONCLUSIONS 

There are probably several reasons why none of the tests were 
statistically significant. Some of these are as follows: 

1 ) The programs were too short. 

2) The required changes were too minor. 

3) An insufficient number of samples was taken. 

4) Variances among individual programmers' abilities are so 
large that only very large differences between sample 
means will be statistically significant. 

5) There are too many variables to isolate whether or not the 
differences can actually be attributed to the type of documen- 
tation used. 

6) There actually is no real significance between the sample 
populations. 

The author believed that (1) and (2) above may have played very 
important roles in this experiment. These limitations were accepted 
so as not to impose a hardship upon the volunteers who were making the 
changes. However, these limitations may have precluded the observations 
of any significant differences in the experiment. 

Number (3) above does not appear to be near as critical as (4). 

The standard deviation among the programmers was so large, that had the 
difference between the means remained constant, the sample size could 
have been increased to 120 and still not have been statistically signi- 
ficant. 
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The large number of variables, number (5) above, is a problem 
that is extremely difficult to resolve in an experiment of this nature. 
The ideal situation would be to have only one program that is being 
changed, by two groups of programmers. One group using audio 
documentation, the other using conventional. However, this presents 
the problem of the difference in abilities of the two groups of program- 
mers. Thus, the question could arise as to whether or not the dif- 
ference should be attributed to the type of documentation used or to 
progranmer abilities. To resolve this question, one can use two 
programs, and thus both groups get to use both types of documentation. 
This immediately leads to the comparison of the difficulty of the 
two programs. All of which brings back the original premise that 
there may possibly be too many variables involved to obtain a test 
that is statistically significant. The authors do not believe 

this is the case, but it is being presented as an alternative 
possibility. 

The last possibility (#6 above) is that there is no significant 
difference between program maintenance using audio documentation 
and program maintenance using conventional documentation. Looking 
back at the data, arid after evaluating the four tests, this has to 
be considered a very strong possiblity. 



SUGGESTIONS FOR FURTHER RESEARCH 


Although the results of this experiment failed to prove that 
one type of documentation is better than the other for program 
maintenance purposes, the authors are convinced that additional research 
should be conducted into the use of audio techniques. The experiment 
demonstrated that much more detail can be easily provided by audio 
documentation than by conventional documentation; however, the experi- 
ment as conducted was somewhat limited and may have partially nullified 
this advantage. 

To test fully the effectiveness of the two techniques, longer 
programs should be used and more complicated changes attempted. The 
changes should affect more than one section of the programs being 
tested, and thus, a better evaluation of the differences of the techniques 
should be provided. 

Indications are that audio documentation is easier and faster 
to prepare; however, a detailed cost analysis study (which was beyond 
the scope of this project) would be required to prove or disprove this 
point. 

Several of the programmers admitted that they had no real idea 
as to what to expect from the audio documentation, and that they 
could probably utilize it better if they were to use it again. In 
future experiments, programners should be provided better training in 
the use of audio documentation prior to the actual experiment itself. 
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SUMMARY 

The experiment conducted in this paper demonstrated that for 
assembly language programs of approximately 300 lines of code, program 
maintenance time is approximately the same when using either audio 
documentation techniques or conventional documentation techniques, 
thus, audio techniques should be considered as an alternative to the 
conventional forms of program documentation. Further research should 
be conducted to determine the effectiveness of the technique for 
longer programs requiring more complicated changes. 

The most important advantage of audio documentation is the volume 
and degree of detail it can provide about 'the program. There is 
absolutely no realistic way that conventional documentation can compete 
in this area. This should prove to be especially advantageous when the 
maintenance programmer has not written the original code. 

A second advantage of audio documentation may be that it is easier 
to prepare. Drawing a neat, detailed flowchart using a template is 
a time consuming job. Drafting and processing the textual material 
to support a conventional documentation package is even more time 
consuming. 

The detail provided by audio documentation becomes even more 
important whenever a program listing is poorly commented. Programmers 
are often hesitant -to fully comment a program before it is completely 
debugged because of the numerous changes that often have to be made. 

If comments have already been included, then a double change is usually 



necessitated. They usually have good intentions of fully commenting 
the program after it is completely debugged, but for one reason or 
another, they seldom do. The use of audio documentation greatly 
alleviates this problem in that the comments are merely placed on the 
tape. 

Perhaps a fourth advantage of the audio documentation technique 
is that it virtually forces an organized approach to program maintenance, 
whereas a programmer using conventional documentation may or may not 
have an organized plan of attack. 

Two of the disadvantages of audio documentation are inherent to 
any sequentially accessed file: (1) It is more difficult to change, 

and (2) Advance/rewind time to the desired position on the tape may be 
significant. 

Thus, audio documentation is presented as an alternative to the 
conventional documentation process. Whether or not it should be 
implemented at any particular data processing center depends upon many 
factors. These include the characteristics of the projects being 
documented, the technical environment, and management's commitment to the 
concept. 
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ABSTRACT 

This paper is a summary of current methods available for the 
editing of text on a computer. A brief discussion of the advantages 
of using computer-aided text editing for documentation of computer 
software systems is followed by short reports on present systems, 
and a conclusion. The principal topic of each report is a 
contrast of features characteristic of each system. 



E 


TABLE OF CONTENTS 

I. INTRODUCTION E-3 

II. DISCUSSION E-4 

III; TYPICAL STRUCTURE OF A TEXT EDITOR ... E-5 

IV. SYSTEM REPORTS E-7 

a. ) APL TEXT EDITOR E-8 

b. ) MTST . E-10 

c. ) ASTROCOMP ........ .... E-12 

d. ) DATATEXT . . E-13 

e. ) EDIT E-14 

f. ) ED PROCESSOR . . . E-15 

9.) ATS E-16 

h. ) TEXT/360 E-17 

i. ) HES E-l 9 

j. ) FRESS E-21 

k. ) REDIT/RUNOFF E-23 

l. ) TEXT- E-24 

m. ) NLS E " 25 

V. CONCLUSIONS E-27 

VI. TABLES AND CHARTS E-29 



E-3 


INTRODUCTION 

"With the advent of inexpensive terminals that communicate 
directly with a general-purpose computer, there has been a noticeable 
movement in the computing industry towards utilizing the resources of 
the computer in many new, non-numerical applications. For example, 
on-line creation and modification of programs and their documentation 
have become widely accepted as productive and cost-effective uses of 
the computer. In fact, it has been realized that the facilities pro- 
vided by a time-sharing system's central editing program and its 
command language are among the most important determinants of the 
system's convenience, power, and consequent utility. Along the same 
lines, special-purpose computer-assisted text editing packages have 
become accepted in industry and government for the preparation or 
printing of technical manuals, proposals, and other documents in which 
many updates are necessary and revision time is at a premium."^ 

It, therefore, seems evident that some form of text editing package 
would be extremely beneficial in the preparation of documentation for 
computer programs. The ability to produce informative manuals (user 
guides, operators manuals, maintenance procedures, etc.), descriptions 
of the methods employed, formal proposals, at minimal cost and effort, 
with an increase in efficiency, is no longer a nicety, but has now 
become a necessity. 


Van Dam, Andries and David E. Rice, "On-Line Text Editing: A Survey". 
ACM Computing Surveys, Vol . 3, pp. 93-114. 



Discussion 


Typically or traditionally, the method of composing some form of 
text has been merely a typing/proof reading/ retyping task - and it is 
still the same today - but in a slightly modified and extremely more 
efficient form. Today the editing responsibilities of providing a 
clean-looking, errorless manuscript have been placed on the computer. 

This computer text editor still requires much of the same information 
as the old-fashioned human editor; the text itself, the form or format 
that it is to be in, plus the knowledge of what is correct and what 
is not. So in short, the computer text editor is a software package 
which takes text as input, stores it, modifies it according to the 
authors' wishes (accomplished by edit codes), and outputs it whenever 
and however the author specifies. 

The sum product of this is the elimination of the communication 
between author and publisher. The author (programmer or system designer) 
is now capable of producing and publishing his own works with a tremendous 
reduction of time and effort. This would enable the author of a 
computer program to fully document or explain his program with 
much less effort and frustration than before. Furthermore, if his 
program were altered in any way, additions or deletions of documentation 
would only be required in the appropriate places, the additions proof- 
read, and the entire document reprinted on high-speed line printers or 
the like. This capability of using high-speed line printers also 
provides an efficient means of producing many hard-copies of the authors' 
work for distribution. 
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Structure of a Text Editor 

The typical structure of a text editor is briefly outlined in 
Figure 1. Several different forms can be used to input the text 
(keypunched, typewritten code, etc.)* This input is generally decoded 
and fed into the computer text editor. If work is needed on the text, 
it can now be accomplished or it can be accomplished at a previous or 
prior time, depending on the type of text editor. Then the desired 
output is specified and printed or stored for later work or printing. 








Systems Reports 
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NAME OF SYSTEM 

APL TEXT EDITOR 

PRICE 

NOT APPLICABLE 

ON-LINE/OFF-LINE 

ON-LINE 

MACHINE USED ON 

IBM/360, CDC 6600 

LANGUAGE WRITTEN IN 

NOT AVAILABLE 

INPUT FORM(S) 

TELETYPED 

INPUT DEVICE (S) 

IBM 2741 COMMUNICATIONS TERMINAL 

OUTPUT FORM(S) 

TELETYPEWRITTEN 

OUTPUT DEVICE (S) 

IBM 2741 COMMUNICATIONS TERMINAL 

DISCUSSION: 



The APL/TEXT EDITOR is used primarily for form letters or short 
reports. A limiting factor in the size of the data base is determined 
by the amount of space allocated to the APL workspace. 

All input and output is through the IBM 2741 Communications Terminal 
This means that the input rate is determined by the speed of the typist; 
while the output is at the rate of 140 words per minute. 

The system is capable of producing well formatted text (one column 
only) that can be right justified if specified. Typical usage has shown 
that less than five pages of text is the maximum amount easily handled. 
The ability to change typing elements provides for flexibility in fonts 
and styles of type. This would be valuable for short scientific papers. 
Text can also be added at any point of the text, thus enabling its usage 
for form letters. 

The edit commands and rules for this system are relatively simple 
and easy to learn. Experience has shown that only an hour or two is 
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required to learn how to use the system efficiently. (See chart for 
list of capabilities. ) 

COMMENTS : 

The best use of this system would be to provide small reports on 
the status of computer programs or brief overall characteristics (general 
documentation) for a global view. 

It is one of the better small text editing systems. 
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NAME OF SYSTEM 

MAGNETIC TAPE SELECTRIC TYPEWRITER (MT/ST) 

PRICE 

NOT AVAILABLE 

ON-LINE/OFF-LINE 

OFF-LINE 

MACHINE USED ON 

SMALL CONTROL/MEMORY UNIT 

LANGUAGE WRITTEN IN 

NOT APPLICABLE 

INPUT FORM(S) 

TELETYPEWRITTEN, (TAPE) 

INPUT DEVICE(S) 

IBM 2741 Communications Terminal 

OUTPUT FORM(S) 

TELETYPEWRITTEN 

OUTPUT DEVICE(S) 

IBM 2741 Communication Terminal 

DISCUSSION: 



The MT/ST provides neat-looking (but unjustified) form letters and 
manuscripts. It is primarily used for documents of high-use and low- 
change rate. 

The only editing allowed in MT/ST is to substitute equal length 
character strings; to effect a substitution of a larger for a smaller 
string, the entire manuscript with the correction must be copied onto 
a second tape. The correct place for an edit is located by printing out 
the contents of the tape until the area of the edit is approached; the 
operator must then manually stop the processor and retype the line. 

Printing is done on the typewriter at the rate of 150 words per 
minute, and various fonts and type sizes may be used by changing the 
type bal 1 . 

COMMENTS: 

The cost and storage of tapes plus the intricacies of revision 



(but done by the original typist) are two points which must be considered. 

For technical documents which are single column format, use of the 
MT/ST makes correcting easy; once the document is completed, the tapes 
can be erased and reused. The MT/ST would be valuable if it is used 
primarily as a production tool and not as a storage device. 



NAME OF SYSTEM 

ASTROCOMP 

PRICE 

NOT AVAILABLE 

ON-LINE/OFF-LINE 

OFF-LINE 

MACHINE USED ON 

DEC PDB8L 8K MINICOMPUTER 

LANGUAGE WRITTEN IN 

NOT AVAILABLE 

INPUT FORM(S) 

TELETYPEWRITTEN, (TAPE) 

INPUT DEVICE(S) 

TELETYPEWRITER 

OUTPUT FORM(S) 

TELETYPEWRITTEN , PHOTO-COMPOSITION 

OUTPUT DEVICE(S) 

TELETYPEWRITER, PHOTO- COMPOS I TER 

DISCUSSION: 



The ASTROCOMP system is similar to MT/ST in its Intended use (small 
amounts of text, form letters, etc.). This system does have an added 
advantage of having up to four typewriters connected to a single control 
unit (DEC PDP-8). 

The basic editing command is SUBSTITUTE. As in the APL and MT/ST 
systems, the "old" (text to be replaced) is typed in to locate it (thus 
uniquely identifying the text) and the "new" text is then added - replacing 
the old text. 

This system is slightly more powerful than either APL or MT/ST and 
is a bit more reasonable than MT/ST in its editing features. 

It is capable of producing output in photo-composition form, which 
is a feature neither APL nor MT/ST have. 
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NAME OF SYSTEM 
PRICE 

ON-LINE/OFF-LINE 
MACHINE USED ON 
LANGUAGE WRITTEN IN 
INPUT FORM(S) 

INPUT DEVICE(S) 

OUTPUT FORM(S) 

OUTPUT DEVICE (S) 

DISCUSSION: 

DATATEXT is a terminal -oriented, on-line system for data entry, 
change, and retrieval. It is comprised of an IBM 2741 Communications 
Terminal in the user's office, phone linking connections, and an IBM 360. 

The system is comparable to the TEXT 360 system as far as most 
formatting capabilities are concerned, but the DATATEXT system is limited 
to the typewriter terminal for output. (This means 140 words/minute vs. 
line-printer speed for TEXT 360.) 

However, there is an advantage to having typewriter terminals for 
output; that being the ability to have the document (or sections of) 
printed out whenever there is a terminal. This saves-time because 
distribution of the document is not necessary. 


CALL/ 360: DATA TEXT 
NOT AVAILABLE 
ON-LINE 
IBM 360 

NOT AVAILABLE 
TELETYPEWRITTEN 

IBM 2741 
TELETYPEWRITTEN 
IBM 2741 
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NAME OF SYSTEM EDIT 

PRICE NOT AVAILABLE 

ON-LINE/OFF-LINE ON-LINE 

MACHINE USED ON CDC 6000 

LANGUAGE WRITTEN IN NOT AVAILABLE 

INPUT FORM(S) TYPEWRITTEN, CRT KEYED 

INPUT DEVICE (S) TYPEWRITTEN, CRT 

OUTPUT FORM(S) TYPEWRITTEN, CRT DISPLAY 

OUTPUT DEVICE (S) TYPEWRITTEN, CRT 

DISCUSSION: 

The Text Editor (EDIT) subsystem executer data file manipulations 
specified by the time-sharing terminal user. These manipulations are 
performed on a new file or a data file which has been saved in the 
KRONOS permanent file system. 

EDIT allows the user to edit a data file. The data file being 
edited is known as the search file. During editing, the search-pointer 
identifies the line of the search file that is currently accessible. The 
search- pointer can be moved forward and backward during editing to 
specify a new line. The search-pointer is always positioned at the 
beginning of a line. 
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NAME OF SYSTEM 
PRICE 

ON-LINE/OFF-LINE 
MACHINE USED ON 
LANGUAGE WRITTEN IN 
INPUT FORM(S) 

INPUT DEVICE (S) 
OUTPUT FORM(S) 
OUTPUT DEVICE (S) 
DISCUSSION: 


ED PROCESSOR 
NOT AVAILABLE 
ON-LINE 
UNIVAC 1100 
NOT AVAILABLE 
TELETYPEWRITTEN 
TELETYPEWRITTER 

TELETYPEWRITTEN, PRINTED, CARDS 
TTY, PRINTER, CARD- PUNCH 


The ED processor proceeds sequentially through the text. It is 


therefore more efficient to perform editing operation in a more or 
less sequential manner starting at the beginning of the text. 

There are certain processes within the editor which if indiscriminately' 


interrupted can cause the processor to fail. To protect against this, 
the processor is designed to break at certain points when it is safe to 
do so. 

Comments: 

Not much information on this text editor was available at the present 
time. However, it appears to be below average as far as fl exibil ity and 
ease of learning is concerned when compared with other text editor systems. 
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NAME OF SYSTEM 

ADMINISTRATIVE TERMINAL SYSTEM (ATS) 

PRICE 

NOT AVAILABLE 

ON-LINE/OFF-LINE 

ON-LINE 

MACHINE USED ON 

IBM/ 360 

LANGUAGE WRITTEN IN 

IBM 360 ASSEMBLY 

INPUT FORM(S) 

TYPED, PUNCHED 

INPUT DEVICE (S ) 

TYPEWRITER KEYBOARD, CARD READER, MAGNETIC TAPE 

OUTPUT FORM(S) 

TYPED, PUNCHED 

OUTPUT DEVICE (S) 

IBM 2741, CARD PUNCH, LINE-PRINTER 

DISCUSSION: 



This system consists of control and functional programs that permit 
many different text-processing and data-handling activities to be carried 
on simultaneously through different typewriter terminals attached to an 
IBM System/360. Written to operate under 0S/360, the Administrative 
Terminal System runs in a multiprogramming environment. It will run 
concurrently with and independently of other tasks in other partitions/ 
regions. 

COMMENTS: 

The ATS system is one of the most versatile text processing system that 
is available. It is powerful and flexible. The output can be in any 
conventional form and written out at any time. 

This system provides the best approach to solving documentation procedures 
and requirements in regards to cost, ease, and efficiency, as of present. 
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NAME OF SYSTEM 
PRICE 

ON-LINE/OFF-LINE 
MACHINE USED ON 
LANGUAGE WRITTEN IN 
INPUT FORM(S) 

INPUT DEVICE (S) 
OUTPUT FORM(S) 
OUTPUT DEVICE (S) 
DISCUSSION: 


TEXT/360 
FREE FROM IBM 
OFF-LINE 
IBM/360 

PL/I IBM 360 ASSEMBLY 
CARDS 

CARD READER 

CARDS, PRINTED 

CARD PUNCH, LINE-PRINTER 


The TEXT/360 system is strictly an off-line text editor. All text 
is initially read into the computer via keypunched cards. Edit codes 
are embedded in this text prior to the input. 

Once the cards have been read in, the text is stored on magnetic 
tape. Any updating or editing after this is also done by cards, using 
slightly different codes. 

This is rather cumbersome and time-consuming for the initial setup, 
but the power of this system comes from the unlimited amount of text that 
can be read in, the relative ease of updating, and the elaborate printed 
output formats for the text. 

The only feature not readily available on this system is the ability 
to change fonts and type style due to the problems involved in changing 
print chains. 


COMMENTS: 

This is a well-established and widely used system. Its principle 
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value comes from the wide range of features available. Also, the only expense 
to a computer installation would be the running of the software package 
itself. It requires no special equipment and on-line connection expense. 

It is also very easy to learn and use. 

The system provides excellent text editing capabilities for typical 


text production needs. 
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NAME OF SYSTEM 
PRICE 

ON-LINE/OFF-LINE 
MACHINE USED ON 
LANGUAGE WRITTEN IN 
INPUT FORM(S) 

INPUT DEVICE (S) 

OUTPUT FORM(S) 

OUTPUT DEVICE(S) 

DISCUSSION: 

The Hypertext Editing System is a flexible, CRT-based system 
allowing full editing and formatting capabilities. It is oriented 
towards "typeset" output (using a computer line printer) as well as 
flexible input and on-line editing. A lightpen and a set of "function 
keys", under program control, are used to indicate to the system the 
nature of the edit to be performed. The portion (s) to text to which 
the function applies are then indicated by pointing at the text with 
the lightpen. No command codes for the functions need be remembered, 
and no extra typing is required to indicate a context string. 

Editing comnands are INSERT, DELETE, SUBSTITUTE, REARRANGE, 
and copy. 

Many formatting options are available so that text may be formatted 
both for on-line display and hard-copy printouts. Usually the TEXT/360 
program is used for final hard-copy printing. 

HES has a unique, however, complicated data structure. A practical 


HYPERTEXT EDITING SYSTEM (HES) 

FREE FROM IBM 
ON-LINE 

IBM S/360 WITH IBM 2250 CRT 
IBM 360 ASSEMBLY 
KEYED INPUT 

IBM 2250 (CRT), LIGHT PEN 
CRT DISPLAY, TYPEWRITTEN 

IBM 2741 Communications Terminal, Line Printer 
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example of a HYPERTEXT system might be an on-line encyclopedia or a 
set of programming and systems reference manuals, with each cross- 
reference lightpen sensitive. 

COMMENTS : 

Even though many nice features are available through this system 
easy editing by lightpen and random accessing to any point within the 
text, providing efficient time-saving updates, it is more costly due 
to the expensive CRT with lightpen facilities and large amounts of 
computer time required to operate the system. 
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NA*E OF SYSTEM 
PRICE 

ON-LINE/OFF-LINE 
MACHINE USED ON 
LANGUAGE WRITTEN IN 
INPUT FORM(S) 

INPUT DEVICE(S) 
OUTPUT FORM(S) 
OUTPUT DEVICE (S) 
DISCUSSION: 


FILE RETRIEVAL AND EDITING SYSTEM (FRESS) 

$35,000 or $500/month 

ON-LINE 

IBM/360 
NOT AVAILABLE 

TELETYPEWRITTEN, KEYED 

IBM 2741 COMMUNICATIONS TERMINAL 
IBM 2260 CRT 

TYPEWRITTEN, PHOTO -COM POSITION 

IBM 2741 COMMUNICATIONS TERMINAL 
LINE PRINTER 
PHOTO- COMPOSER 


FRESS is a sophisticated and cost effective text manipulation system, 
commercial ly available, and capable of supporting a spectrum of terminals 
in such a way that all functions are available even on the lowest power 
terminal s. 

FRESS is the production version of the predecessor prototype HES. 

Beyond normal editing and formatting commands of most text editors, 
FRESS includes completely arbitrary size string edits, pattern scanning, 
keyword retrieval, photo-composition output, interfile linking and editing, 
and protection of files and blocks of text by passwords. 

COMMENTS: 

Eventhough the price is somewhat steep, the capabilities and usage of 
this system far exceed any other system reviewed to date. 

The commands are simple, but extremely powerful, and easily learned. 
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FRESS was designed more in the light of being dynamic than other 
systems, therefore indicating that the system can be "tailor-made" for 
the customer. 
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NAME OF SYSTEM 

REDIT/RUNOFF 

PRICE 

NOT AVAILABLE 

ON-LINE/OFF-LINE 

ON-LINE 

MACHINE USED ON 

TSS/360 

LANGUAGE WRITTEN IN 

NOT AVAILABLE 

INPUT FORM(S) 

TELE TYPEWRITTEN 

INPUT DEVICE (S) 

TELETYPEWRITTEN 

OUTPUT FORM(S) 

TELETYPEWRITTEN, PRINTED 

OUTPUT DEVICE (S) 

TELETYPEWRITTEN, LINE-PRINTER 


DISCUSSION: 

A terminal is connected to TSS/360 by telephone lines of text are 
typed on the terminal , transmitted to TSS/360 and permanently stored. 

The text is entered without concern for staying within certain margins 
or running of the bottom of the page. Special format control words are 
included in the document text which informs the document printer as 
to margins, size of paper, spacing, paragraphs, etc. 

Delete character and line symbols allow typing errors to be corrected 
as they are made. Typing errors which have been stored are easily corrected 
with the text editor. In addition a document can be revised by adding, 

del i ting or re-arranging sections of text. 

The document can be printed at the terminal at various stages of 

revision. 

COMMENTS: 

As far as time-sharing editing systems are concerned, this is one of 
the better thus far reviewed. It provides powerful commands and is 

relatively easy to learn. 



NAME OF SYSTEM 

TEXT 

PRICE 

Not Available 

ON-LINE/OFF-LINE 

ON-LINE 

MACHINE USED ON 

Sigma 6/7/9 

LANGUAGE WRITTEN IN 

Not Available 

INPUT FORM(S) 

Tel etypwritten 

INPUT DEVICE ( S ) 

Tel etypwritten 

OUTPUT FORM(S) 

Tel etypwritten 

OUTPUT DEVICE(S) 

Teletypwritter, Printer 

DISCUSSION: 



TEXT is Xerox's text editing system. It is an on-line system that 
is quite similar to ATS and other line text editors. 

The only problem that is immediately evident is the fact that it is 
designed, to operate on the Sigma computers, which may hinder using TEXT 
as a documentation aid for producing automatic program documentation 
for an programs on any machine. 

Comments: 

Disregarding other factors and considering only text editing 
capabilities, TEXT is a very powerful and capable text editing system. The 
commands are sinple and it is easy to learn how to use. Definitely it 
should be high on the list of available text editing systems. 
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NAME OF SYSTEM 

NLS; TNLS (TYPEWRITER NLS); DNLS (DISPLAY NLS) 

PRICE 

NOT CURRENTLY AVAILABLE OUTSIDE THE ARPA NETWORK 

ON-LINE/OFF-LINE 

ON-LINE 

MACHINE USED ON 

DEC PDP 10 

LANGUAGE WRITTEN IN 

UNAVAILABLE 

INPUT FORM(S) 

TELETYPE, CRT 

INPUT DEVICE (S) 

ANY TERMINAL ACCEPTABLE TO ARPA NETWORK 

OUTPUT FORM(S) 

TELETYPE, CRT, PRINTER 

OUTPUT DEVICE (S) 

ANY DEVICE ACCEPTABLE TO ARPA NETWORK 

DISCUSSION: 



The NLS text manipulation and editing system were developed by 
the Augmentation Research Center of Stanford Research Institute. NLS 
is used as part of ARPA Network Information Center (NIC). NIC performs 
information retrieval functions. 

When working with NLS through a terminal one is at all times con- 
structing, studying, or modifying a file. NLS files have a hierarchical, 
tree, or outline structure. 

NLS has commands which manipulate data on a file level and on the 
text level. On the file level data is loaded, updated, verified, output 
and locked or unlocked all through terminal commands. On the text level 
it is possible to access data in the hierarchy directly by giving a tree 
address, or relatively according to the current portion being viewed. 
Commands allow the user to proceed to the next item at the same level. 



forward or back, to go up levels or down levels. Text is stored and 
viewed in upper and lower case founts. 

Data is easily updated, move , copied or deleted. It can be 
viewed on any level with easy transition between levels. Output to 
any device can be controlled from the terminal. 

The NLS system can be used with any terminal accepted by the ARPA 
Network or with the Special terminal developed by the Augumentation 
Research Center which uses a 5-key keyboard and a "mouse" to control 
the cursor in addition to the normal terminal keyboard. 

COMMENTS: 

This is perhaps the most powerful and versatile text editor reviewed. 
It's use is at present limited to members of the ARPA Network and 
personnel at SRI. 
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Conclusion 

Computer aided editing of text has become an established 
cost-effective use of computers. There exists as wide a range of 
text editors as there are varieties of text. For small amounts of text, 
such as memoranda, form letters, brief descriptions, or update reports, 
systems like the MT/ST, APL text editor, or ASTROCOMP are effective 
and money-saving. However, for large amounts of text that require 
more storage, more intricate formats, etc., to produce program des- 
criptions, user manuals, etc., systems like the ATS, TEXT/360, NLS, 

FRESS would produce the best results. 

Any of the systems mentioned previously can be extremely valuable 
to anyone who uses them, provided that their requirements are in 
accordance to the system's capabilities and limitations. It is sometimes 
advisable to employ a combination of these systems to accomplish any 
desired task. 

The principle advantage is not a direct result of these capabilities. 
It is the indirect effect it has on the documentor. For example, the 
typical computer programmer enjoys the programming itself, but lacks 
the desire to sit down and tediously write good documentation for it. 

The inability to use the computer to help with this task frustrates 
and annoys him. But with a computer text editor, he is able to type in 
any information or explanation he likes, changes it at a later date if 
it is not what he wants, and provides himself and his co-workers with 
a good, well -formatted and well -documented explanation of what he 
has done, all with minimal effort. 
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It can therefore be concluded, that a computer aided text editing 
system can cut the cost of printed material, stimulate the desire to 
document, and provide a means to keep the documentation up-to-date. 
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Foreword to Table I 

The following table lists the most of capabilities of text editors. 
Each text editor feature is briefly described. 

In most cases these capabilities are given mnemonic codes which 
are instructions to the text editor. They are most commonly embedded 
within the input text itself. 

These commands, represent the power of the system to update text 
and to produce formatted text documents. 
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TABLE I 


Capabilities of the Systems 

1) TEXT COLUMNS - the ability to have text printed in one or two columns. 

2) PAGE/TEXT WIDTH - the ability to specify the number of characters 

per line; either one or two columns. 

3) PAGE/TEXT DEPTH - the ability to specify the number of lines on a 

page (normal range: approximately 25 to 75 lines). 

4) NEW PAGE/NEW COLUMN - for shipping to a new page/column or several 

pages/columns. 

5) RUNNING HEADS AND FEET - allows for running heads (title, subtitle, 

date, etc.) and running feet, to be printed on each page, only 
even-numbered, or only odd numbered. 

6) RIGHT-HAND PAGES - allows for text to be' only printed on one side 

(right-handed). 

7) "AS-IS" TEXT - allows for text to be printed in any format that is 

inputed (blanks are not squeezed out, or added to aid in right 
justification). 

8) CENTERED TEXT - provides for specified text to be centered, equally 

between right and left hand margins. 

9) LINE-SPACING - specifies single or double-spaced printing. 

10) BLANK LINES - provides for skipping lines. 

11) PARAGRAPHS - specifies that a line should be skipped and indented 

a specified or default number of spaces. 

12) INDENTIONS - allows for a specified indention for any line of text. 

13) HANGING INDENTIONS - allows for the text to be indented for as many 

lines as specified. 

14) COLUMN JUSTIFICATION - causes all the text columns on a page to be 

equal in length by spacing the columns out to the page depth. 

15) LINE JUSTIFICATION - causes all text lines to be spaced out to the 

line length by the insertion of blank characters between words. 

16) TABULAR TEXT - specifies tab settings and indicates the text to be 

printed at the settings. 

17) HYPHENATION - allows the program to hyphenate the last word on a line 

if needed for justification purposes. 
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18) FOOTNOTES - allows specified text that is to be printed as a footnote. 

19) HEADINGS - provides for line(s) of text that are set apart from the text 

body and provides a description of the section that follows it. 

20) KEEPS - specifies a portion of text, such as a table, heading, or the 

like, so that it is not split between two columns or pages. 

21) TABLES - allows the preparation of tables and charts within the text. 

22) HORIZONTAL LINES - provides the ability to print horizontal lines. 

23) VERTICAL LINES - provides the ability to print vertical lines. 

24) CAPITALIZATION - allows capital letters. 

25) UNDERSCORING - allows the underscoring of any text. 

26) USER-DEFINED CODES - permits the user to define his own code which can be 

comprise of combinations of regular edit codes. (This capability 
is generally used for repetitive edit functions) 

27) SUPPLEMENTAL LISTINGS - provides specified text to be printed at 

specific times, (generally used to create Table of Contents, 
list of figures, etc.) 

28) MULTIPLE PRINTING OF TEXT - allows specified pages or documents to 

be printed more than once at any given time. 

29) REVISION BARS - allows updated text to be indicated by a vertical bar in the 

margin, signifying that portion of text has been revised. 

30) RENUMBERING - permits the automatic renumbering of pages in a document 

or report after updating (addition or deletion of text). 

31) REPAGING - permits the automatic repaging of text. 

32) VARIABLE STYLES - allows for the use of special characters within a 

text. Normally this is limited to the type of print chain 
available or the kinds of typing elements available. 
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Foreword to Table II 

This table lists what are commonly referred to as the edit 
commands. These commands differ from the format commands in the 
fact that they are used to manipulate portions of text to make 
changes, deletions or insertions within a document instead of 
formatting the text itself. 

These commands generally vary the most in format from one 
system to the next, but all systems can accomplish these basic 
functions. 
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TABLE II 

Editing Features 


1) ADDITION/DELETION OF CHARACTERS 

2) ADDITION/DELETION OF LINES 

3) ADDITION/DELETION OF PARAGRAPHS 

4) ADDITION/DELETION OF PAGES 

5) TRANSFERING CHARACTERS 

6) TRANSFERING LINES 

7) TRANSFERING PARAGRAPHS 

8) TRANSFERING PAGES 



NAME OF SYSTEM 


A PL 


MTST 


ASTROCOMP 


ON-LINE/OFF-LINE 

On-Line 

Off-Line 

Off-Line 

INPUT FORM(S) 

Typed 

. Typed, Tape 

Typed, Tape 

OUTPUT FORM(S-) 

Typed 

Typed 






EDITING FEATURES 




ADD/DELETE CHARACTERS 

Yes 

Yes 

No 

ADD/DELETE WORDS 

Yes 

Yes 

No 

ADD/DELETE LINES 

Yes 

Yes 

Yes 

ADD/DELETE PARAGRAPHS 

Yes 

Yes 

Ye 8 

ADD/DELETE PAGES 

Yes 

Yes 

Yes 

TRANSFER WORDS 

Yes 

No 

No 

TRANSFER PARAGRAPHS 

No 

No 

Yes 

TRANSFER PAGES 

No 

No 

Yes 





FORMAT FEATURES 




TEXT COLUMNS 

No 

No 

Yes 

PAGE/TEXT WIDTH 

Yes 

Yes 

Yes 

PAGE/TEXT DEPTH 

Yes 

Yes 

Yes 

NEW PAGE/NEW COLUMN 

Yes /No 

Yes/No 

Yes/No 

RUNNING HEADS AND FEET 

No 

No 

No 

RIGHT-HAND PAGES 

No 

No 

No 

"AS- IS TEXT" 

No 

Yes 

No 

CENTERED TEXT 

Yes 

Yes 

Yes 

LINE-SPACING 

Yes 

Yes 

Yes 

BLANK LINES 

Yes 

Yes 

Yes 

PARAGRAPHS 

Yes 

Yes 

Yes 

INDENTIONS 

Yes 

Yes 

Yes 
























































































HANGING INDENTIONS 

Yes 

Yes 

Yes 

COLUMN JUSTIFICATION 

No 

No 

No 

LINE JUSTIFICATION 

Yes 

No 

Yes 

TABULAR TEXT 

No 

No 

Yes 

HYPHENATION 

No 

No 

Yes 

FOOTNOTES 

Yes 

Yes 

Yes 

HEADINGS 

Yes 

Yes 

No 

KEEPS 

No 

No 

Yes 

TABLES 

No 

No 

Yes 

HORIZONTAL LINES 

No 

No 

Yes 

VERTICAL LINES 

No 

No 

Yes 

CAPITALIZATION 

Yes 

Yes 

Yes 

UNDERSCORING 

Yes 

Yes 

Yes 

USER-DEFINED CODES 

No 

No 

No 

SUPPLEMENTAL LISTINGS 

No 

No 

No 

MULTIPLE PRINTINGS 

Yes 

Yes 

Yes 

REVISION BARS 

No 

No 

No 

RENUMBERING 

Yes 

Yes 

Yes 

REPAGING 

No 

No 

No 


VARIABLE STYLES 


Yes 


Yes 


Yes 



















































































NAME OF SYSTEM 1 DATA TEXT 1 EDIT I ED PROCESSOR 


ON-LINE/OFF-LINE 

On-Line 

On-Line 

On-Line 

INPUT FORM(S) 

TTY 

TTY 

CRT 

OUTPUT FORM(S) 

TYPED, PRINTED 

TYPED 

CRT DISPLAY, 
PRINTED 



EDITING FEATURES 


ADD/DELETE CHARACTERS 


ADD/DELETE WORDS 


ADD/DELETE LINES 


ADD/DELETE PARAGRAPHS 


ADD/ DELETE PAGES 


TRANSFER WORDS 


TRANSFER PARAGRAPHS 


TRANSFER PAGES 


FORMAT FEATURES 


TEXT COLUMNS 


PAGE/TEXT WIDTH 


PAGE/TEXT DEPTH 


Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 7 

Yes 

Yes 

Yes 

Yes 

Yes 



NEW PAGE/NEW COLUMN 

Yes 

Yes /No 

Yes/No 

RUNNING HEADS AND FEET 

Yes 

No 

No 

RIGHT-HAND PAGES 

Not Available 

No 

No 

"AS- IS TEXT" 

Yes 

No 

No 

CENTERED TEXT 

Yes 

Yes 

Yes 

LINE-SPACING 

Yes 

Yes 

Yes 

BLANK LINES 

Yes 

Yes 

Yes 

PARAGRAPHS 

Yes 

Yes 

Yes 

INDENTIONS 

Yes 

Yes 

Yes 
























































































FORMAT FEATURES (cont.) 


HANGING INDENTIONS 

Yes 

Yes 

COLUMN JUSTIFICATION 

Yes 

No 

LINE JUSTIFICATION 

Yes 

No 

TABULAR TEXT 

Yes 

No 

HYPHENATION 

Not Available 

No 

FOOTNOTES 

Yes 

No 

HEADINGS 

Yes 

Yes 

KEEPS 

Not Available 

No 

TABLES 

Yes 

No 

HORIZONTAL LINES 

Not Available 

No 

VERTICAL LINES 

Not Available 

No 

CAPITALIZATION 

Yes 

Yes 

UNDERSCORING 

Yes 

Yes 

USER-DEFINED CODES 

Not Available 

Not Available 

SUPPLEMENTAL LISTINGS 

• 

Not Available 

Not Available 

MULTIPLE PRINTINGS 

Yes 

Yes 

REVISION BARS 

Not Available 

No 

RENUMBERING 

Yes 

No 

REPAGING 

Yes 

No 



Yes 

No 

No 

No 



Yes 

No 

No 

Not Available 
No 


No 

No 


VARIABLE STYLES 


Yes 


Yes 


No 












































































NAME OF SYSTEM 


ATS 


TEXT/360 


HES 


ON-LINE/OFF-LINE 

ON-LINE 

OFF-LINE 

ON-LINE 

INPUT FORM(S) 

TTY 

CARDS 

KEYED INPUT 

OUTPUT FORM(S) 

TYPED, PRINTED, 

PAT>nS TAPP. 

PRINTED 

CRT DISPLAY, TYPED 



EDITING FEATURES 
ADD/DELETE CHARACTERS 
ADD/ DELETE WORDS 


ADD/DELETE LINES 


ADD/DELETE PARAGRAPHS 


ADD/DELETE PAGES 


TRANSFER WORDS 


TRANSFER PARAGRAPHS 
TRANSFER PAGES 

FORMAT FEATURES 
TEXT COLUMNS 
PAGE/TEXT WIDTH 
PAGE/TEXT DEPTH 
NEW PAGE/NEW COLUMN 
RUNNING HEADS AND FEET 
RIGHT-HAND PAGES 
"AS- IS TEXT" 

CENTERED TEXT 

LINE-SPACING 
BLANK LINES 
PARAGRAPHS 



Yes 

Yes 

No 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes/No 

Yes 

Yes 

Not Available 

Yes 

Yes 

Not Available 

Yes 

Yes 

Not Available 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 


INDENTIONS 


Yes 


Yes 






























































































NAME OF SYSTEM 


ATS 


TEXT/360 


HES 






FORMAT FEATURES (cont. ) 

Yes 

Yes 

No 

HANGING INDENTIONS ' 

Yes 

Yes 

No 

COLUMN JUSTIFICATION 

Yes 

Yes 

Yes 

LINE JUSTIFICATION 

Yes 

Yes 

Not Available 

TABULAR TEXT 

Yes 

Yes 

Yes 

HYPHENATION 

Yes 

Yes 

No 

FOOTNOTES 

Yes 

Yes 

Yes 

HEADINGS 

Yes 

Yes 

Yes 

KEEPS 

Not Available 

Yes 

Not Available 

TABLES 

Yes 

Yes 

Not Available 

HORIZONTAL LINES 

Not Available 

Yes 

Not Available 

VERTICAL LINES 

Not Available 

Yes 

Not Available 

CAPITALIZATION 

Yes 

Yes 

Yes 

UNDERSCORING 

Yes 

Yes 

Yes 

USER-DEFINED CODES 

Not Available 

Yes 

Not Available 

SUPPLEMENTAL LISTINGS 

Not Available 

Yes 

Not Available 

MULTIPLE PRINTINGS 

Yes 

Yes 

Yes 

REVISION BARS 

Hot Available 

Yes 

Not Available 

RENUMBERING 

Yes 

Yes 

Yes 

REPAGING 

Yes 

Yes 

Yes 


Limited to 


VARIABLE STYLES 


Yes 


No 



















































































NAME OF SYSTEM 

FRESS 

REDIT/RUNOFF 

TEXT 

ON-LINE/OFF-LINE 

ON-LINE 

ON-LINE 

ON-LINE 

INPUT FORM(S) 

KEYED INPUT 

TTY 

TTY 



ADD/DELETE CHARACTERS Yes | Yes [Yes 


ADD/DELETE WORDS 

Yes 

Yes 

Yes 

ADD/DELETE LINES 

Yes 

Yes 

Yes 

ADD/DELETE PARAGRAPHS 

Yes 

Yes 

Yes 

ADD/DELETE PAGES 

Yes 

Yes 

Yes 

TRANSFER WORDS 

Yes 

Yes 

Yes 

TRANSFER PARAGRAPHS 

Yes 

Yes 

Yes 

TRANSFER PAGES 

Yes 

Yes 

Yes 



FORMAT FEATURES 




TEXT COLUMNS 

Yes 

Yes 

No 

PAGE/TEXT WIDTH 

Yes 

Yes 

Yes 

PAGE/TEXT DEPTH 

Yes 

Yes 

Yes 

NEW PAGE/NEW COLUMN 

Yes 

Yes 

Yes/No 

RUNNING HEADS AND FEET 

Yes 

Yes 

Yes 

RIGHT-HAND PAGES 

Yes 

Yes 

Yes 

“AS- IS TEXT" 

Yes 

Not Available 

Yes 

CENTERED TEXT 

Yes 

Yes 

Yes 

LINE-SPACING 

Yes 

Yes 

Yes 

BLANK LINES 

Yes 

Yes 

Yes 

PARAGRAPHS 

Yes 

Yes 

Yes 

INDENTIONS 

Yes 

Yes 

Yes 




















































































NAME OF SYSTEM press I redit/ runoff j text 


FORMAT FEATURES (cont. ) 

Yes 

Yes 

Yes 

HANGING INDENTIONS 

Yes 

Yes 

No 

COLUMN JUSTIFICATION 

Yes 

Yes 

Yes 


LINE JUSTIFICATION 

Yes 

Yes 

Yes 

TABULAR TEXT 

Yes 

Yes 

Yes 

HYPHENATION 

Yes 

Yes 

Yes 

FOOTNOTES 

Yes 

Yes 

Yes 

HEADINGS 

Yes 

Yes 

Yes 

KEEPS 

Yes 

Not Available 

Yes 

TABLES 

Yes 

Not Available 

Yes 

HORIZONTAL LINES 

Yes 

Not Available 

Yes 

VERTICAL LINES 

Yes 

Not Available 

Yes 

CAPITALIZATION 

Yes 

Yes 

Yes 

UNDERSCORING 

Yes 

Yes 

Yes 

USER-DEFINED CODES 

Yes 

Not Available 

No 

SUPPLEMENTAL LISTINGS 

Yes 

Yes 

Yes 

MULTIPLE PRINTINGS 

Yes 

Yes 

Yes 

REVISION BARS 

Yes 

Yes 

No 

RENUMBERING 

Yes 

Yes 

Yes 

REPAGING 

Yes 

Yes 

Yes 

VARIABLE STYLES 

Yes 

Yes 

Yes 
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NAME OF SYSTEM 

NLS, TNLS, DNLS 

ON-LINE/OFF-LINE 

ON-LINE 

INPUT FORM(S) 

TTY, CRT 

OUTPUT FORM(S) 

Typed, CRT, printed 


EDITING FEATURES 

YES 

ADD/DELETE CHARACTERS 

YES 

ADD/DELETE WORDS 

YES 

ADD/DELETE LINES 

YES 

ADD/DELETE PARAGRAPHS 

YES 

ADD/DELETE PAGES 

YES 

TRANSFER WORDS 

YES 

TRANSFER PARAGRAPHS 

YES 

TRANSFER PAGES 

YES 



FORMAT FEATURES 


TEXT COLUMNS 


PAGE/TEXT WIDTH 


PAGE/TEXT DEPTH 


NEW PAGE/NEW COLUMN 


RUNNING HEADS AND FEET 


RIGHT-HAND PAGES 


"AS- IS TEXT" 


CENTERED TEXT 


LINE-SPACING 


BLANK LINES 


PARAGRAPHS 


INDENTIONS 
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ABSTRACT 


This report defines a program editor, differentiates between a 
program editor and free- form text editor, and delineates the two 
major categories of program editors: on-line and off-line. It shows 

that the characteristics of on-line program editors may differ because 
of the particular type of terminal involved. 

The report lists the information sources tapped and responses 
received. Next is a comparison of six on-line editors and a comparison 
of eleven off-line editors, both in tabular form. 

Finally, there is a list of criteria for an ideal program editor 
and a nomination of the on-line editors and the off-line editors which, 
in the author's opinion, come closest to satisfying the listed criteria. 
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INTRODUCTION 


A program editor is basically a software package which allows one 
to modify and document one or more source program modules without the 
danger of hand-carrying (and possibly dropping or losing) sizable decks 
of cards and without the attendant need for reading in and compiling 
the entire source module(s) every time a change is incorporated. As such, 
a program editor is a rather specialized version of a text editor (a 
software package for the manipulation of free-form textual material). 

A program editor differs from a text editor in the way its material 
is stored and displayed. Storage in card image or printer line image 
format is generally quite adequate for performing the "in place" 
modification - substitution of one opcode, operand, address, label, etc., 
for another - of computer source programs. Free-form text editors, 
because of their more powerful capabilities of arbitrary placement and 
replacement of arbitrarily sized character strings, require a flexible 
storage stucture, one capable of a noticeable amount of dynamic expansion 
and contraction. For this the unit of storage must be at least a 
"super-line" of several hundred characters, and may even be a paragraph 
or a whole page. 

For the output of a program editor, only an upper case character 
set is needed; and the text is printed as it was stored, line by line. 

A text editor is limited if it does not have at least upper and lower 
case in its character set, because the fairly complex typesetting codes 
it employs would lose a great deal of their impact in such an environment. 



Program editors fall into one of two categories: on-line or off-line, 

depending on their mode of operation. Off-line editors are automatically 
self-documenting, providing a hard-copy listing of all changes made during 
the current run and, optionally, a wide variety of reports covering such 
areas as a program evolution history and a current file status summary. 
On-line editors provide no such automated documentation, relying on the 
individual programmer or another documentation system to perform this 
function. 

Off-line editors permit the creation of entire source modules only, 
whereas on-l,ine editors allow the user to create new routines as he thinks 
them up, one statement at a time. Since off-line editors are governed 
by control cards supplied by the user, an error-handling technique is 
provided. In most cases, if an error is encountered on a control card, 
all modifications of the source module to which the control card applies 
are ignored. One noteworthy exception to this is "Simple", an off-line 
program editor from Computer Services which terminates the program upon 
finding any errors in its control cards. On-line editors can immediately 
alert the user to any errors in control information. Upon correction, the 
user may then proceed with the editing of the program. 

Various on-line editors exhibit differences due to the type of 
terminal they employ. Those communicating with the user via a teletype/ 
typewriter (TTY) terminal show marked similarities to off-line editors 
in the method of specifying operations and in the manner in which the 
text is presented. For this reason, any reference to on-line editors 



in the comparison of these methods and manners in the two following 
paragraphs will apply only to those using cathode-ray tube (CRT) units 
as terminals. 

For an off-line editor, specifying what is to be done and where it 
is to be done requires a command name or abbreviation together with a 
location denoted by a line number and/or context string. An on-line 
(CRT) editor typically requires "pointing" to the target text area via 
a light-pen, a keyboard-controlled cursor, etc., then modifying the text 
by (perhaps depressing a function key and) typing the new text right over 
the old. 

With an off-line editor, the user is forced to work from some printed 
copy, making changes thereon and transcribing those changes, resulting in 
duplication of effort. Because an on-line (CRT) editor simultaneously 
displays many lines of text with virtually no time lag, the user can 
think out and implement desired changes in one operation instead of two. 

BACKGROUND 


Over the past three months, the following sources have been searched 
for information on the subject of program editors: Auerbach Computer 
Technology Software Reports, Journal of the Association for Computing 
Machinery (ACM), ACM Computing Surveys,ACM Computing Review, Com- 
munications of the ACM, U.S. Government Research and Development Reports, 
Proceedings of the AFIPS Fall and Spring Joint Computer Conferences, the 
Computer Journal ,, the IBM S/360 OS Utilities manual, the Univac 1100 Series 
Operating System Programmer Reference, and the Control Data 6000 Series 
Computer Systems KR0N0S Text Editor Reference Manual. 
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The Auerbach Reports carried information about a large number of 
data manipulation packages, four of which were found to be worthwhile 
as (off-line) program editors. Two of the four originating firms have 
sent further literature in response to our request for same; one firm 
remains untraceable. The ACM Computing Surveys carried information on 
seven (on-line) program editors. Two operated on certain source languages 
only (one on JOVIAL, the other on PL/I and Gedanken) and have therefore been 
omitted*; requests for additional information on the rest remain as yet 
unanswered. 

In addition, letters have been sent to thirteen manufacturers of 
source program maintenance packages listed in the 1971 edition of the 
Datamation Industry Directory. Four positive replies have been received 
as of this date; one other firm has gone out of business. 

STATE OF THE ART 


Sumnarized in the following tables are the characteristics of six 
on-line and eleven off-line program editors. The on-line editors treated 
are: Conversational Context-Directed Editor (CMS), developed at the IBM 

Cambridge Scientific Center; WYLBUR, developed at the Stanford Computation 
Center; Quick Editor (QED), developed by the University of California 
at Berkeley and revised extensively for commercial use by Com- Share, Inc. - 
the only editor of either category to maintain additional files of editing 
changes for testing slightly different versions of a program without 
modifying or duplicating the original program; Text Editor and Corrector 
(TECO), developed by the Massachusetts Institute of Technology and Project 

* All program editors treated in this report will operate on any 
computer source program, written in any source language. 
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MAC; TVEDIT, developed by the Stanford Computation Center; and EDIT, 
developed by Control Data Corporation for its KRONOS Time-sharing 
System. 

The off-line editors treated are: LIBRARIAN, by Applied Data 

Research, Inc.; SIMPLE, by Computer Services; Card Library On Tape 
(CLOT), by International Telecontrol Corporation; PROGRAM/MANAGE, by 
Management Systems Corporation; Card File Maintenance System (CFMS), 
by Sigma Software Company; PAN VALET, by Pan soph ic Systems, Incorporated; 
PLUS D/A, by the Cull inane Corporation; the Source Program Library 
System (SPLIS-II), by the Webster Computer Corporation; IEBUPDAT and 
IEBUPDTE, two IBM System/360 Operating System Utilities programs; 
and the ED Processor, a text editor which is part of the Univac EXEC-8 
Monitor. 

Within the tables, an entry of "Not Given" means: "Has or could 

« 

have this attribute, but no conclusive information given." An entry 
of "Not Applicable" means: "Could in no way have this attribute." 

For insertion of a character string or replacement of a shorter one 
by a longer one, if the record length is exceeded, an entry of 
"Truncation" means: "Any excess is ignored and lost," while an entry 


of "Overflew" means: "Any excess causes no insertion/replacement to 

be made, and a warning to be issued." 



ON-LINE PROGRAM EDITORS 



Computer Configuration 


Man-Machine Interfac 


Storage Requirements (bytes) 


Language Written In 


Target Record Type 


Target Record Size (characters) 


Target Record Processing Fashion 


Target Text Pinpoint Location Requirements | Relative Line No. 


Fixed position (Label) Scan Capability 


trary Posi ti-on (Context String) 
Scan Capability 


Record-Oriented Single Record 

Commands 

(handle at a time) Multiple Records 


IBM S/3bO/o7 under 
CP/CMS Operating System 


IBM 2741 TTY 


Not Given 


I Not Given 


Not Given 


Fixed Length Line 


Pages • Sequential , 
Random within Page 


WYLBUR 

IBM S/3bO/oY under 
OS /MFT - 3 disk drive 


IBM 2741 TTY 


Not Given 



IBM S/ 36 OBAL 


Variable Length Line 


1-133( Default is 72) 


Random 


Absolute Line No. 



Insert, Dele te , Replace | Insert, Dele te, Repla c 


Insert, Delete 


S tr ing-Or ien ted 
Commands 
(operate within) 


Single Record 


Limited Record Range I Replace 


Insert, Delete, Replace 


Insert, Delete, 

Replace (Truncation) 


Replace (Truncation 


Machine - 
Readable 
Output 


Hard-Copy 
Documental ion 
Output 


Security Controls 


Additional Capabilities 



apabili tv for Testing 


Updated Master File 


Job Stream JCL Retrievable 
from System or Library 


Job Stream Execution without 
Operator Intervention 


Selected Modules in 
Punched Deck Form 


Current Run 
Permanent Edit Listing 


dated Module Listing 


Program Evolution History 


Current File Status Summary 


Tabbing Capability 


Tabbing Capability 












QED 


Not Given, 
disk drive 


TTY 


Not Given 


Not Given 


Not Given 


Variable Length 


1-500 


Random 


Relative Suoer-Line TTo. 


Yes 


Yes 


Insert, Delete, Replace 


Insert, Delete, Replace 


Replace (Truncation) 


Replace (Truncation) 


Replace (Truncation) 


Yes 


Yes 


Not Applicable 


Not Applicable 


DEC PD P-10, 

1 disk drive 


TTY 


4K 


Not Given 


Not Given 


Variable Length Page 


Unlimi ted 


Relative Character or 
Line Disnlacement 


No 


es 


Not Arrolicable 


Not Applicable 


Insert, Delete 


Insert. Delete 


Insert, Delete 


No 


Yes 


Not Applicable 


Yes 


CRT 


Not Given 


Not Given 


Not Given 


Variable Length Page 


1-128 per line 


Random 


Absolute Page No., 
followed by Visual Sea 


No 


No 


Delete 


Not Applicable 


t, Delete 
aracter a 


Not Applicable 


Not Applicable 


No 


Yes 


Not Applicable 


Not Applicable 


CDC 6000 series under 
KR0N0S. 1 disk drive 


TTY 


Not Applicable 


Not Applicable 


Not Given 


Variable Length Line 


1-150 (Default is 72) 


Random 


Relative Line No. 


No 


Yes 


Insert .Delete, Replace 


Insert .Delete .Replace 


Insert, Delete, 
Replace (T runcat ion 


Not Applicable 


Yes 


Yes 


Not Applicable 


Not Applicable 


No 

No 

No 

No 

Not Applicable 

Not Applicable 

Not Applicable 

Not Applicable 

Not Applicable 

Not A noli cable 

Mot Applicable 

Not Applicable 

Not Applicable 

Not Applicable 

'Not Applicable 

Yes 

Not Applicable 

Not Applicable 

Not Applicable 

Not Applicable 

Not Applicable 

Not Applicable 

Not Applicable 

Not Applicable 

None 

None 

None 

None 

None 

Arithmetic, Tabbing 

Capability 

Command Repetition 
Fac tor 

Module Manipulation; 
Elimination of Excess 
Blanks 
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OFF-LINE PROGRAM EDITORS 



LIBRARIAN 

SIMPLE 

Computer Configuration 

IBM S/ 36 O under OS or 
DOS, 1 disk drive 

IBM S/360/30 , 370 under 
OS or POS . 1 disk'drivr 

Man-Machine Interface 

Card Reader/Punch, 
Printer 

Card Reader/Punch, 
Printer 

Storage Requirements (bytes) 

59K 

65K 

Cost 

$3600 for 1st 3 years, 
then $500 per year 

$2800 for 1st 3 years, 
then $100 per year 

Language Written In 

IBM S./360 BAL 

IBM S/360 BAL 

Target Record Type 

Fixed Length Card Image 

Fixed Length Card Image 

Target Record Size (characters) 

80 

80 

Target Record Processing Fashion 

Sequential 

Not Given 

Target Text Pinpoint Location Requirements 

Absolute 

Card Sequence No. 

Not Given 

Fixed Position (Label) Scan Capability 

No* 

No 

Arbitrary Position (Context String) 
Scan Canabilitv 

Yes 

Yes 

Record-Oriented 

Commands 

(handle at a time) 

Single Record 

Insert, Delete, Replace 

Insert, Delete .Replace 

Multiple Records 

Insert, Delete, Replace 

Not Given 

String-Oriented 
Commands 
(operate within) 

Single Record 

Insert, 

Replace (Overflow) 

Replace (Truncation) 

Limited Record Range 

insert,' 

Replace (Overflow) 

Not Given 

Entire Record Range 
(Universal) 

Insert, 

Replace (Overflow) . 


Temporary Edit Capability for Testing 

Yes 

No 

Machine - 
Readable 
Output 

Updated Master File 

Yes 

Yes 

Job Stream JCL Retrievable 
from System or Library 

Yes 

Not Given 

Job Stream Execution without 
Operator Intervention 

Yes (MFT/MVT only) 

No 

Selected Modules in 
Punched Deck Fora 

Yes 

No 

Hard-Copy 

Documentation 

Output 

Current Run 

Permanent Fdi _.T, 1st tnrr .. 

Yes 

Yes 

Current Run 
Temporary Edit Listing 

No 

Not Applicable 

Updated Module Listing 

Yes 

Yes 

Program Evolution History 

Yes 

Yes 

Current File Status Summary 

Yes 

Yes 

Security Controls 

Unchanging, b;, passable , 
pgm-gene rated password 

Password-based 
scrambled character set 

Additional Capabilities 

COBOL (any level) 
Syntax checker (12K 
bytes); Resequencing; 
Module Manipulation 

COBOL Macro ana 
Abbreviation Expansion: 
Module Manipulation; 
Resequencing 
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OFF-LINE PROGRAM EDITORS 


CLOT 

PROGRAM /MANAGE 

CFMS 

PANVALET 



IBM S/360, 370 under 
^ h^voe 

IBM S/360/22, 370/135 
03 or DOS. 1 c s drive 

Card Reader, Printer 

Card Reaacr/ Punch, 
Printer • 

Card Reader/Punch, 
Printer 

Card Reader/Punch, 
Printer 

Not Given 

32K 

32K 

19K 

Ihb'J plus optional $10C 
per year maintenance 

$<2485 each 
authorization 

$900 plus optional $428 
installation charge . 

$3780 plus optional $60C 
ner vear maint. after 3 

COBOL 

COBOL 

COBOL 

Not Given 

WSBBBBBA 

Fixed Length Card Tmaffe 

Fixed Length Card Image 

Fixed Length Card Image 

80 

80 

80 

80 

Random 

Not Given 

Not Given 

Sequential 

Absolute 

Card Sequence No. 

Absolute 

Card Sequence No. 

Not Given 

| f mm i ^4f 

No 

No 

No 

Yes 

No 

No 

No 

Yes 

Insert, Delete 


Insert. Delete 


Insert, Delete 

Insert, Delete, Replace 

Insert, Delete 

Insert, Delete, Renlace 

Not Applicable 

Not Applicable 

Not Applicable 

Scan and Print only 

Not Applicable 

Not Applicable 

Not Applicable 

Scan and Print only 

Not Applicable 

Not Applicable 

Not Applicable 

Scan and Print only 

No 

No 

No 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

No 

No 

Yes ■ 

No 

No 

No 

Yes 

No 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Not Applicable 

Not Applicable 

Not Applicable 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

mmmm 

Yes 

Yes 

No 

Yes 

Yes 

Yes 

None 

None 

None 

Up to 3 levels of 
security control coder, 

Resequencing 


None 

Module Manipulation; 


Resequencing 


I OF 
l o 


None 


Module Manipulation; 
Formatting; Fesequen- 
cing; Cross Referencing 
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OFF-LINE PROGRAM EDITORS 


PLUS D/A 

SPLIS-II 

IEBUPDAT and IEBUFDTE 

ED 

IBM S/360, 370 under 
OS or DOS, 1 disk drive 

IBM S/360/30, 370 under 
DOS, 1 disk drive 



Card Reader/ Punch, 

Printer 

Cara Keader/Punch, 
Printer 

Card Reader/Punch, 
Prin ter 


50K 

ULk 

Not Applicable 

Not Applicable 

$3500 for 1st 3 years, 
f-.hpn $525 Tier vear 

$2500 1 installn, $2000 
2nd, $.1500 each a.dditnl 

■HHHHI 

Not Applicable 

IBM S/360 BAL 

COBOL 

Not Given 

Not Given 

Fixed Length Card Image 

Fixed Length Card Image 

Fixed Length Card Image 

Fixed Length Line 

80 

80 

80 

Not Given (Default 80) 

Sequential 

Random 

Random 

Random 

Absolute 

Card Seouence No. 

Not Given 


Relative 

Card Semience No. 

No 

No 

No 

Yes 

No 

No 

No 

Yes 

Insert, Delete, Replace 

Insert, Delete 

Insert, Delete, Replace 

Insert .Delete. Replace 

Insert, Delete, Replace 

Insert, Delete 

Insert, Delete, Replace 

Insert, Delete 

Not Applicable 

Not Applicable 

Not Applicable 

Replace 

Not Applicable 

Not Applicable 

Not Applicable 

Replace 

Not Applicable 

Not Applicable 

Not Applicable 



Replace 

Yes 

Yes 

No 

■ ■ ""I 

Yes 

Yes 

Yes 

Yes 

■ j 

Yes 

Yes 

Not Given 

Not Applicable 

Not Applicable 

No 

No 

Not Applicable 

1 

Not Applicable 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes . 

No 

Yes 

Not Applicable 

Yes 

Yes 

Yes 

Yes 

Yes | 

Yes 

No 

No 

No 

Yes 

Yes 

No 

« 

No 1 

Ins tallation-changeable 
scrambled charge • _o r set 

■■■■■ 

None 

None 

Resequencing 

Module Manipulation; 
Re sequencing 

Resequencing; Change 
Data Set Organization 
(IEBUPDTE only) 

Tabbing Capability; | 

Module Manipulation 

... , — J 
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CONCLUSIONS: THE "IDEAL" PROGRAM EDITOR 

While user requirements differ widely, and no one program editor 
could ever satisfy all potential users, certain desirable character- 
istics do stand out above the rest. The "ideal" program editor should 
be capable of: 

1. Easy mastery by programmer personnel (a minimal amount of 
memorization and time required for entry of edit command 
codes and operands) 

2. High-speed response 

3. Processing records out of sequence 

4. Universal replacement of character strings 

5. Inserting a character string or replacing a shorter with a 
longer without fear of truncation 

6. Maintaining files for edit operations, applicable at will 
to a master file 

7. Creating a job stream for compilation/ execution of changed 
modules, with JCL capable of being accepted from the user 
and/or operating system and/or source program library 

8. Producing hard-copy documentation of all permanent and 
temporary changes made during the current run and a history 
of all changes ever made to a given module 

9. Displaying many lines of text simultaneously, with the ability 
to display any portion of the entire text very rapidly (requires 
an on-line editor with a CRT terminal) 

Of the program editors treated in this report, the two most nearly 
satisfying these ideal requirements for both categories are: 

1. On-Line - TVEDIT and WYLBUR 

2. Off-Line - LIBRARIAN and PANVALET 
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ABSTRACT 


The various forms of data encountered in FORTRAN, COBOL, and PL/I, are 
described at the local and global levels, along with ambiguities that arise 
within each language. 

Suggestion for a syntax directed general purpose algorithm is also 


discussed. 
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FORTRAN 


Local Level - Detailed 

The IBM FORTRAN H compiler presents a local map of names en- 
countered during a compilation. All names used as variables, state- 
ment functions, subprograms and internal functions. 

All names are accompanied by descriptive tags. A brief des- 
cription of each tag follows: 


Isa 

A 

F 

S 

C 


Descri ption 

The variable was used as an 
argument. 

The variable has appeared on 
the right of an equal sign. 

The variable has appeared to 
the left of an equal sign. 

The variable is in COMMON. 


E 

IF 


The variable has appeared in 
an EQUIVALENCE statement. 

Indicates an internal function. 


NR 


The variable has not been 
referred to. 


SF 


Arithmetic statement functions. 


XF 


A subprogram. 


XR 


Variables, arrays or subprograms 
that are referenced by name. 


The FORTRAN (H) compiler also produces a relative address for 
those names that are used internally. AIT functions and subprograms 
are assigned a relative address of 000000. 


The type and length of each variable is also displayed as part 
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of the MAP option. For example, a double precision real variable would 
have a TYPE of R*8. 

A description of COMMON blocks is also given. The name of each 
block is presented along with the length of the block. All variables 
in the block are described in the same manner as presented under the 
MAP option, with the exception of an identifying tag. 

Following this data layout is a map of any equivalence made for 
the block. This is in the form of the variable name and its offset 
from the beginning of the block. 
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Local Level - Detail Suppressed 

There is currently no method for suppressing detail. The FORTRAN 
(G) compiler does separate the scaler variables from the array variables. 
It seems a combination of this feature along with the COMMON way 
presented by the FORTRAN (H) compiler would be a good approach to a 
local level description of the data. 

A restriction of the above to arrays only would also appear to be 
an approach to suppression of detail at the local level. The data layout 
for all arrays and any equivalences on an array would be quite functional 
at the local level. This could be accomplished by utilizing the source 
code and generating the data layout from all specification statements 
which allow dimensioning. Equivalences could be resolved before the 
final output of the layout. 

Some type of abbreviated notation would be applicable in the pre- 
sentation of the array structures. For example, the presentation of a 
2-dimensional array with subscript limits of 5 and 10 respectively 
might be presented as follows 

A(1 , 1) . . . A( 1 , 10) 


A(5 , 1) . . . A{5 , 10) 
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A notation for describing the storage method used might also be 
considered. Consider the following: 


A(l, 1) . . . A(1 , 10) 


A(5, 1) 
* 


A(5 , 10) 
* 


* * 

* * 


st 

1 5 locations last 5 locations 

in memory for in memory for 

this array this array 



Global Level 


There is currently no procedure for illustrating global data 
structures. A reasonable approach to this problem would require an 
analysis and collection of information in several, categories. 

The COMMON statement and any equivalences affecting COMMON must 
be considered for a global layout. The actual parameters in any 
FUNCTION or SUBROUTINE call must be analyzed since they are essentially 
global variables. An analysis of formal parameters in a SUBROUTINE or 
FUNCTION statement require analysis because they may certainly be 
representing a data structure at the global level. Actual parameters 
may also have an interaction with other variables via an EQUIVALENCE 
statement, thus the EQUIVALENCE statement must be inspected closely. 
Formal parameters may not be included in an EQUIVALENCE statement, hence 
we can disregard it in this instance. 

The collection of the above information for subsequent processing 
is necessary for any global layout of data. Of course, it should be 
clear that relationships among the main program and subprograms will 
control the layout of any data relationships that exists across program 
boundaries. 

It seems that a sophisticated system would be required to handle 
any data layout on the global level. Generally, the above problems can 
be applied to other high level programming languages such as COBOL and 
PL/I. Thus, a system should be designed so that it could be table 
driven and applicable to any of the mentioned languages. Table driven 
would essentially mean to supply to syntax and semantics of the few 
statements in each language which affects global layout. 
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Ambiguities 

The EQUIVALENCE statement causes the sharing of locations in 
FORTRAN. This allows the partitioning and extension of one data 
structure by possibly several other data structures. 

This presents problems at both the local and global level since 
COMMON variables and actual parameters may appear in the EQUIVALENCE 
list. 
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COBOL 

LOCAL LEVEL-DETAILED 

The use of the option DMAP will provide information about names in the 
COBOL source program. The following will be a description of the information 
that is output as a result of specifying the DMAP option. 

The internal name generated by the compiler is output in order to 
facilitate the reading of the object code. The level number of the 
particular name is also generated when applicable. The description FD 
is used when the name is a file definition name. The source name used in the 
program is also output hence we have available three descriptions of importance: 
1) the internal name, 2) the level number, and 3) the source name. 

The remaining descriptors can be classed in the area of usage and 
location. All data names will have a base and displacement associated 
for the purpose of describing relative locations within the data structure. 

DECB and DCB information is presented in the case of file names. The storage 
assigned to the data name is described in terms of bytes used and also in 
terms of the type of data associated with that name. For example, the 
storage definition could be described in terms of characters or fullwords 
depending on the usage clause for that variable. This information is presented 

in assembler language terminology. 

The usage of names is described in the following manner. For FD 
entries the access method utilized is identified. All group items are 
identified as such and all elementary items are described in terms of their 


USAGE clause. 



All data - names that redefine other data names are described with the 
tag R. Any data names for which an OCCURS has been specified is described 
with the tag 0. A Q indicates that the data - name is the object or 
contains the object of the DEPENDING ON option of the OCCURS clause. An 
M indicates that the format of the records of the file is: 

F = fixed 
V - variable 
U - undefined 
S = spanned 
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LOCAL LEVEL - DETAIL SUPPRESSED 

Currently there is no procedure for suppressing the detail at the local 
level. The approach to pursue would parallel the FORTRAN and PL/ I approach. 

Two types of information would be informative at the local level in 
a functional sense. The data names which have OCCURS clauses specified 
for them are candidates for a data lay out. Again, as in FORTRAN and PL/I 
one must consider the possibility of memory sharing through the use of the 
REDEFINES clause. The second type of data layout would be created from the 
FD sections. Hence the record layouts could be described. This is essentially 
done vy the DMAP option yet many other variables are interspensed and the 
record layouts are not readily discerned in this environment. 

The above approach would require an analysis of the DATA division quite 
rigorously. Again, as in FORTRAN and PL/I, a syntax driver algorithm could 
possibly be utilized for this purpose. 



GLOBAL LEVEL 


The conventions used in COBOL for subroutine linkages are quite similar 
to that used in FORTRAN. The key to a global analysis of COBOL would be the 
detection of the USING clause in the CALL statement. The isolation of all 
identifiers that follow and are non- scolar is the next step to be taken 
in the construction of a data layout. 

The utilization of the source code as input and the output of the 
variables that are global type variables is the required task in such 
an environment. The consideration of the DEFINED clause is quite necessary 
to resolve or analyze any sharing of locationslby variables. 
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AMBIGUITIES 

The DEFINED statement is the COBOL statement that causes the sharing 
of locations in COBOL. The problem requires analysis in order to adequately 
describe both local and global layouts. 



Local Level - Detailed 


The IBM PL/I compiler (F) produces a detailed description of all 
identifiers that are used in a PL/I program. The IBM compiler will be 
used as the focal point in the description of the information which can 
be obtained about identifiers. To activate a detailed printout of the 
attributes of identifiers, the user must utilize the compiler option ATR. 
The following description demonstrates the attributes that are presented 
at the detailed level. 

All arithmetic variables have a set of attributes that may include 
the following: 

a. BINARY! DECIMAL 

b. FIXED| FLOAT (SINGLE | DOUBLE) 

c. PICTURE 

d. INITIAL 

e. DEFINED 

f. ALIGNED! UNALIGNED 

g. dimension information 

h. precision 

i. STATIC] AUTOMATIC 

j. INTERNAL | EXTERNAL 

String variables are described with many of the same attributes as 
arithmetic variables. For example i) represents the storage class and 
j) represents the scope of the variable or identifier. These attributes 
are present for all types of identifiers. The following is a list of 
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attributes for string variables: 

a. BIT | CHARACTER 

b. PICTURE 

c. INITIAL 

d. DEFINED 

e. ALIGNED | UNALIGNED 

f. precision 

g. dimension information 

h. storage class 

i . scope 

One can easily see that many attributes are available via the ATR 
option. These are presented in alphabetical order with the declaration 
statement # associated with the identifier. 

In addition to the above attributes, all elementary items of a 
structure are described. All major and minor structure names are 
correctly identified in the listing. 

Other fringe type attributes are also available. For example, 
ENTRY, RETURNS, GENERIC, BUILTIN, etc. are descriptions of variables. 
Another area which may be considered is that of file descriptions. The 
ATR option permits the description of files. For example, such attri- 
butes as INPUT, OUTPUT, UPDATE, SEQUENTIAL, DIRECT are available. 

The above demonstrates that a very detailed description of identi- 
fiers is available as output of the PL/I compiler. This is restricted 
to a single compilation and hence it applies essentially on the local 
level. 
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Local Level - Detail Suppressed 

In addition to the attributes of the identifiers, the compiler 
produces an aggregate length table which is the length in bytes of all 
major structures and non structured arrays. This table is produced by 
the IBM compiler when the ATR option is used. This presents a very 
functional presentation of the overall structure of the major components 
of the identifiers. 
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Global Level 

There are no present tools available to present a data layout over 
separate compilations. There are possibly two approaches to such a 
global description of data structures. 

The first approach would necessitate a program to analyze the 
declaration statements of the source language. All identifiers which 
have the attributes of EXTERNAL and STATIC are candidates for a global 
data layout. 

The second approach would require an analyzation and interpretation 
of the ESD which the compiler produces. All external symbols which are 
placed in a COMMON control section should be considered for a global 
presentation. In addition to these identifiers, under certain conditions 
control sections of the type SD will be created for global identifiers. 
This control section is not a COMMON control section but is accessible 
by other compilations thus, in effect, it is common to other procedures. 
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Ambiguities 

The possibility of misinterpreting or misrepresenting the data 
layout exists because of the DEFINED attribute. The DEFINED attribute 
essentially causes the sharing of memory by several identifiers. This 
presents a problem in the presentation of the data layout since we may 
now have several arrays and structures utilizing the same memory 
locations. 

This problem is also complicated by allowing character arrays to 
have other names specified for part of the character strings. This is 
implemented by the use of the POSITION attribute in conjunction with 
the DEFINED attribute. 
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CONCLUSIONS 

Clearly, if one considers the source languages of the three languages 
at a global level, it becomes apparent that all have similar methods for 
transmission of variables, redefinition of variables and declaration of arrays 
and structures. PL/I is the encompassing language in the sense that it 
includes the features of both COBOL and FORTRAN. 

Since the features, which must be considered, are quite similar the 
approach of a syntax driven collection algorithm might be quite feasible. 

The fact that considerably enhances such an approach is that fact that such 
a limited analysis of source statements is necessary. The main considerations 
are to be given to specification statements and calling - answering sequences. 
The types of specification statements will include array specification, 
structure specification and redefinition statements. 

The above approach could be applied for a global layout and a subset 
could be utilized at the local level for a functional picture of the data 
structures. The local level detailed layouts are handled adequately by 
the compilers and the emphasis should be placed on the detail suppressed 
mode and global description. 
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ABSTRACT 

This paper investigates the state of the art of documentation 
standards. The few standards that do exist are reviewed and standards 
at various levels are suggested where possible. It was found that 
existing automatic documentation packages fail to meet any sort of 
standards. 

Systems Documentation and Program Documentation are then discussed 
with an overview of what is generally acceptable and what might be in- 
corporated into a set of standards. 

Existing flowchart and decision table standards are presented. 
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INTRODUCTION 

Basically, Systems Documentation may be categorized into developmental 
documentation and control documentation. Since one of the major problems 
constantly discussed in almost any technical or administrative setting is 
the problem of poor communication, the above documentation types are intended 
to lessen this problem. Developmental documentation is descriptive of the 
system itself, i.e., performance characteristics, tools and materials. It 
is therefore the means of communication about the system. Control documen- 
tation is concerned with communicating information about resources used to 
develop the system and Involves project development organization, personnel, 
time, materials, and money. 

Systems designed are never static. They must change to meet new 
customer requirements or in order to be compatible with hardware and 
software modifications. More often than not the designer of the original 
system is no longer available to make the necessary changes, therefore a 
clear and complete record of what each system does and how it was developed 
is essential. Hence, at least some standard must be developed in order to 
assist the programmer/analyst in preparing good documentation to establish 
a common language of communication. 

Program documentation deals more specifically with producing what might 
be called a Job Documentation Package or a Program Manual. In general, the 
aim in writing programs is to use the computer to solve problems which are 
too tedious, repetitive or uneconomical for manual methods. From some 


\ 



problem definition and solution specification, detailed program logic 
is designed, and the program coded and tested. The product is thus a 
proved and documented (hopefully) program ready for operation, probably 
initially operated within a test environment. 

There is a wide range of application differences, however within 
such a definition of a program, from a scientific problem-solving 
application which can perhaps be defined and solved by a single person 
to a detailed systems specification requiring many designers and progranmers . 

The former may serve a one-time purpose and specific records of input 
and file records may not be necessary. In this case rather little doc- 
umentation may be required. 

The case of the detailed systems specification made up of a number 
of program specifications describing some complex data processing system 
is much more complex. Here, many "in-house" progranmers will be involved 
and possibly outside contractors will be employed. In this case, it is 
generally agreed that accurate program documentation is a must. 

The real problem in setting standards is to specify how much documen- 
tation is required and from whom. No national standards for program 
documentation exist, but some software packages are commercially available 
to produce automatic documentation at the program level. Although rather 
poor in general and far from meeting even the most loosely defined set of 
standards, they are an attempt at standardization. 
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SYSTEMS DOCUMENTATION STANDARDS 


State of the Art 

In any discussion concerning standards, it is first necessary to lay 
some ground rules. First of all, what are standards and what has been 
standardized? 

Currently the only set standards for computer software and/or 
computer software documentation deal specifically with standard flowchart 
synbols and abbreviations list, and decision table standards. 

Beyond these items, the word "standards" generally refer to what a particular 
installation feels is necessary. Very little information has been found 
concerning standards of any kind* but most reports on any type of standards 
do agree in some broad areas. 

At present, there are no universal documentation standards which are 
directly applicable to all installations. This is true because of the type 
and level of complexity of documentation for one location may be inadequate 
or inappropriate in another environment. Each data processing department 
must therefore implement a documentation system which suits its own 
environment. This could be done by adapting a general documentation system 
to local conditions. 

The development of a documentation system for a particular data 
processing organization must take account of the major influencing factors 
which include: 



(1) management comml tment 

(2) project characteristics 

(3) corporate environment and organizational characteristics, and 

(4) technical environment 

In any event, with respect to systems documentation, the following 
documents mi ght be recommended. 

(1) A User Request - which is the initial approach for the user 
for data processing assistance. It contains a brief problem 
description. 

(2) The Systems Proposal - essentially a major report resulting 
from a systems survey. It may be considered as a feasibility 
report, including a detailed specification of the recommended 
approach and project plan. 

(3) The Analytical Report - essentially a project plan, supplemented 
as necessary with evaluation information. 

(4) The Design Requirement Statement - which is essentially a 
specification of requirements in systems terms.. 

(5) The Systems Summary - is a general description of the complete 
system or system change. 

(6) File Specification - a detailed description of the purpose, 
contents and organization of a file. 

(7) Transaction (Input) Specifications - This document describes all 
inputs to the system. 



H-7 


(8) Output Specifications - This document details the systems outputs- 
why and when produced, contents, formats and recipients. 

(9) Segment (Processing) Specification - essentially a statement of 
the design requirements and general logic for a program. 

(10) Systems Test Plan - A permanent record of the testing procedure 
to prove the system prepared by the systems design function. 

(11) Programming Specifications - (which are discussed separately 
later) 

The above list of systems documents are basically those of Gray & 

2 

London i n Documentation Standards . 

The present state of the art on the above set of documents follows 
the trend of filling out appropriate printed forms for each step in the 
documentation process. These forms are generally suited to the individual 
needs of the specific installation and seem to follow no real fixed pattern. 
No mention is made of automatically producing any of these forms or their 
equivalents. It seens very feasible that a great deal of this documentation 
could be automatically produced, as is discussed in other reports. 

Suggested Standards for Systems Documentation 

The problem of how much documentation is needed for a particular 
system is the obvious problem here. In addition to the standards mentioned 
in discussing the state of the art, minimal standards should include most 
of the following. 
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I. Systems Flowcharts - Flowcharts provide a means of identifying 
programming functions and graphically visualizing the logic 
and the path of its flow in the solution of a problem. Generally, 
two levels of flowcharts are recommended. A third level, a MICRO 
or logic detailed flowchart may be desirable but can be considered 
as optional. 

A. First Level System Flow. This level should be a general system 
flow, giving an overview of the major processing areas and 
programming requirements (programs) that will be required for 
system development. This flow should be in block form to 
identify the core resident programs and the programming path 
necessary to accept, process and output data. The general 
flow should also show the support routines, e.g., overlay, and 
coirmon routines. The first level flow may require more than 
one page to identify core resident and support programs or 
routine. Core resident programs should be grouped within a 
block to show the processing area to which the program belongs. 
Systems should be designed so core resident and support 
routines/programs are developed in modular form. 

1. Core resident and support routines developed to aid 
processing and message switching functions should be 
identified by name or subject, followed by some distinguish- 
able alphanumeric program name. 
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2. A flow depicting the hardware configuration should be 
drawn showing all hardware and peripheral components, 
and the path of the data flow through the system. 

B. Second level MACRO flow. The programming functions identified 

in the first level system flowchart should be developed into 

MACRO flow (semi-detailed) diagrams. 

1. Some method for identifying each symbol or block of the 
MACRO flow should be used. 

2. The MACRO flowchart expands the program or major processing 
function of the first level into semi -detailed component 
blocks or programming symbols. Flowchart pages should be 
numbered. 

3. As the second level flowcharts are reviewed by the lead 
programmer/analyst, processing errors and omissions 
should be detected prior to coding. 

4. The MACRO flow should depict, in graphic and symbolic 
form, input/output functions, subroutine, major processing 
functions and the processing sequence for the coding of a 
program. It should be in sufficient detail to permit 
another programmer to develop the source coding. 

5. Standard flowcharting symbols should be used. 

6. The general flow should be from top to bottom, left to 
right. 

7. Off-page connectors should contain unique tags or 



coordinates to which they point* a.id the flowchart page 
number. If the off-page connector does not relate to the 
preceding page, show the page number of the page where 
the flow was broken, e.g. from page 4 of 12. 

8. On-page connectors should contain unique tags or 
coordinates to which they point. 

Narrative Documentation 

A. Systems Reference Manual. 

While the system is under development, a general narrative should 
be written giving a brief history and purpose of the system. This 
will serve as the composite document for the system and will be 
developed concurrently with the system. The introductory chapter 
will give the development history and identify each program/ 
routine and contain a brief statement giving the purpose and 
function of each program/routine. This first chapter should 
contain the first level block diagram flows. Subsequent chapters 
should contain the second level MACRO flowchart and a general 
narrative for each program. 

B. Operator (User) and Test and Acceptance Manuals Information for 
the Operator's and the Test and Acceptance Manual, as applicable, 
can be lifted from the program abstract and other narratives as 
the system is being developed. This information, along with the 
Systems Reference Manual, will be developed concurrently with the 
system. 



C. When a system is ready for implementation, system documentation 
should be submitted to a Documentation Library. 

"Stand-Alone" Programs or Modifications to existing programs. 

A. When a "stand-alone" program is developed or a modification 
to existing programs takes place, it should be narratively 
documented. 

B. When the program is ready for release, the documentation, as 
required, should go to some Documentation Library. 



PROGRAM DOCUME NTATION STAN DARDS 

State of the Art 

Just as there are many different ways to write a program as there 
are programmers, there are as many ways to document a program. To 
determine what program documentation is necessary or sufficient is the 
purpose of program documentation standards. 

The United States Air Force 14 feels that acquiring and maintaining 
accurate and up-to-date documentation is an essential part of the soft- 
ware production and maintenance process. Well -documented programs are 
necessary in effective communication of software system ideas and techniques 
between organizations with both operational and economic benefits. In 
addition, good documentation 

1. allows the lead programmer/analyst to review the efforts of 
an individual programmer to ensure conformance with system 
design criteria. 

2. assists programmers in testing and debugging. 

3. enables programmers to update old programs with minimal 
difficulties. 

4. permits new programmers to learn their systems without having 
to recode programs to discover what they do. 

5. makes available information that can be used in the design of 
new systems within a given unit and to eliminate duplication 
of effort wherever possible. 
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Recommended Standards for Program Documentation 

The following is a set of general recommendations which can be 
adopted, or at least partially so, as the required standards for program 
documentation. These standards were collected from several sources, 
each different installation making suggestions with slight variations. 

A consensus of the standards reviewed recommends that a program 
manual , a complete final document of a program, should be prepared. It 
should contain: 

1. a general description of the function, use, and methodology of 
the program. 

2. a description of input, files and output used or produced by 
the program. 

3. flow diagrams showing the logic of the program. (Flow diagrams 
are discussed later in this report.) 

4. a description of instructive output messages, e.g. output on 
console or printer, etc. 

5. coding information, e.g. an assembly listing, memory print, 
descriptions of matrices or tables used. 

6. a test plan. 

7. program test and operating instructions. 

Operations Documentation should be prepared partially by the system 
designer and partially by the programmer. This documentation, prepared 
for both the user and the data processing operations staff, should contain: 



1. Program Test Instructions, ?. docrrvrt crnr'i^d of those 
instructions which are necessary to guide the computer operator 
in running a test program, prepared by the programmer. 

2. Systems Operating Instructions, a list of processing steps, in 
execution sequence, defining all operating requirements. It 
should include: 

a) Summary workflow schedule 

b) Data collection and preparation instructions 

c) Input control instructions 

d) Job assembly instructions 

e) Output review and control instructions 

A basic collection of forms for System Operating Instructions 
would include; 

a) workflow summary 

b) general clerical 

c) data preparation (i.e. keypunching) 

d) auxiliary machine (by machine category) 

e) computer operating (by computer type) 

Each operating instruction form should bear the basic identifying 
information comprised of at least: 

a) systems identification 

b) operation identification (brief title) 
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c) step number for this operation 

d) previous operation step number/next operation step number 

e) date 

f) originator/authority 

Any number of other entries may appear on each form. These may 
include: 

a) responsibility for performing the instructions 

b) input: description and source 

c) output: description and destination 

d) process: summary of functions performed 

Each specific type of form will have further detail pertinent 
to that particular form. These forms can be quite lengthy and, 
rather than list the necessary information for each, a few 
examples follow on the next pages. 

The forms featured in the above suggested documentation can vary 
greatly. Several different forms (i.e. printed forms) may be required 
for any one of them. These forms can be detailed or general, depending 
upon the particular user's needs. Military Standards* 5 generally require 
detailed information while smaller systems, with little outside communi- 
cation necessary, could be documented adequately with less detail. 

At present, most program documentation information is recorded by 
hand. It would be desirable if this documentation could be generated 
automatically from the program and from previously prepared systems 
documentation. No present documentation package offers any means for 


doing this. However, it would be relatively simple to require the 
programmer to input any additional underivable information using a 
CRT. These forms could be produced on the screen ard the programmer 
would enter the necessary information. This information could then be 
printed with the program output. 

Flowcharts can be produced by some packages now available. Flowcharts 
ure in a later section of this report. 



Sample Program Documentation Forms 
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MACHINE SET UP FORM 


PROG NAME 

AREA 

JOB PREQ _ 


PROG ft 


PROJECT 


DIRECT ACCESS REQUIREMENTS: 

PERMANENT 


USER 

ASSIGNED 

PACK 


DATA SET NAME 


USi;R I.D. CODE. 
PROGRAMMER 


REGION SiZE 


DDNAME 


SERIAL ft / 
CELL# 


BIN # 


TEMPORARY 


USER 

ASSIGNED 

PACK 

DATA SET NAME 

, 

DDNAME 

SERIAL ft / 
CELL ft 

SPACE = 

- 






JAPE REQUIREJeiTS: 

#7 trk. UNITS # 9 TRK. units 
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CARD READER REQUI ROOTS: 


DATA SET NAME 

DDNAME 

SOURCE 

DISPOSITION 


























CARD PUNCH REQUIREMENTS: 


DATA SET NAME 

DDNAME 

POCKET # 

DISPOSITION 















■ 



PRINTER REQUIREMENTS: 


DATA SET NAME 

ISS 

PRINT 

'TRAIN 

FORM 

# 

SEJUP 

LINES 

PER 

INCH 

BURST 

DECOL- 

LATE 

DISPOSITION 

































































ADDITION □ REPLACEMENT □ 


DATE SECTION PAGE 















DOCUMENTATION APPROVAL FORM 


Check Type of Release: □ NEW PROGRAM □ MAINTENANCE □ SYSTEM 


SYSTEM OR JOB NAME 

PROGRAM # 

PROGRAMMING 

AREA 

DIRECT INQUIRIES 
TOs 

NAME OF PROJECT 

NAME OF PROGRAMMER 

DATE 


DESCRIPTION OF SYSTEM, NEW PROGRAM OR MAINTENANCE: 



Program Configuration: 
DIRECT ACCESS STORAGE 


Permanent □ Temporary 

DIRECT ACCESS DATA SETS 
O Tables Q' Core Res. Modules 

B Disk Resident Modules 
Data Sets 


terns Affected By This Release: 

D Program □ Documentation 
□ Tables or Data Sets 
Q External Procedures 


Maintenance Priority: 

□ EMERGENCY-Contact Name: 

Phone: 

0 SPECIFIC DATE CYCLE 

WHEN POSSIBLE ~~ 


SUBMITTED BY 


Complete This Section For New Program and 
When Maintenance Affects One of the Following : 

PROGRAM INFORMATION - CHECK ONE FOR EACH ITEM: 


JOB TYPE: 

RUN FREQUENCY: 


ESTIMATED TIME: 
LANGUAGE: 


CORE STORAGE: 


□ Batch □ Teleprocessing 

□ Daily □ Weekly 

B Monthly U Quarterly 
Annually Q On Request 


□ One Time □ 

Minutes 

U COBOL □ FO 

□ RPG □ S/ 

□ PL/1 □ _ 

Enter Region Size 
(Do Not Include OS 


□ FORTRAN 

□ S/360 AL 

□ 


EQUIPMENT INFORMATION - ENTER WHERE APPLICABLE: 


360/65 
Card Reader 
Printer 

Optical Scanner 
Number of Tape Units 

Number of Data Cell 
Drives 


□ 1401 

□ Card Punch 

□ Drum 

□ Data Communications 

i - * r\‘ _ i. 

___ Ulliuer Ul LM*K 

Storage Drives 
Number of 












APPROVALS (Manager Level or Higher) 


(Compl. this line for New Program Only) 
SUBMITTING OFFICE: 

PROGRAMMING AREA: 

NAME 

. DATE 

(Compl. this line for Maintenance Only) 
MAINTAINING OFFICE: 

PROGRAMMING AREA: 



MANAGER REVIEW 



REASON FOR REJECTION OR COMMENTS: 
















Dtt» 

Drawn by_. 




DECISION TABLE FORM 



System N«mt. Airline Reservation Example p m September 1967 

System Numtoer_CX ' Orewr. b y, R. Tomna 



m 

m 

n 

FT 

6 

JL 


1 1 First class requested 

n 

m 

n 

r 

■ 




n 


■ 

m 

■ 

■ 

m 

n 

0 


El 


0 

1 ? 

m 

H 

m 

n 

0 


PI 


_ 

n 

m 

ffl 

m 

p 

0 


9 

Jil 1*1-1 V 1 L-4<i»*» IH tbl •! >■: 1 •! f ;■ 

_ 

m 

m 

■ 

m 

n 

0 





































■ 

m 

■ 

■ 

■ 

0 


6 

Write first class ticket 


n 

n 

0 

n 

0 

0 



Write tourist class ticket 

0 

n 

R 

0 

0 

b 

0 


6 

Ad.lust 1st cl. seat invent. 

H 

n 

n 

0 

0 

0 

0 


a- 


0 

n 

0 

0 

0 

0 

0 


10 


n 

n 

n 

0 

0 

0 

0 


IX 

Go to next request 

0 

n 

B1 

0 

0 

0 

0 









































! i 









! 

■ 

■1 

■ 

■ 

■1 

■ 

0 


! FREQUENCY 2n 1 

m 

19! 

m 


01 

01 



SompiR limited entry docision table 
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NATIONAL STANDARDS 

Flow Chart Standards 

The ANSI Standards define three major groups of flowchart outlines. 

1) Basic - this includes specifications of symbols representing 
four functions considered to be the minimum symbols required for 
adequately representing data processing action. These functions 
are input/output, processing, flow direction, and annotation. 

2) Specialized - consists of outlines for specifying three distinct 
groups: 

a. ' data - carrying media (document, magnetic tape, etc) 

b. peripheral equipment type (on-line storage, menual input, etc.) 

c. selected types of processing action (decision, sort, collate, 
etc.) 

3) Additional - these outlines include symbols for representing 
origins, terminations and functions. 

It appears that flowcharting symbols are one of the few things that are 
generally accepted as standard. These standards are included on the 
following pages. 

Decision Tables 

n . 

Some standards have also been set up for use with respect to decision 
tables. These standards generally adhere to the rules which follow^ 

Examples are also provided. 



SYSTEMS FLOWCHART SYMBOLS 


1. Process Symbol used to represent anv kind of 
processing function, or any operation for which 
no particular symbol is provided. 

2. Decision Symbol used to represent a decision that 
determines which of a number of alternative paths 
is to be followed. 



3. Manual Operation Symbol 


4. Auxiliary Operation Symbol 




V 

A 


8. Sort 


Standard symbols for system flowcharts 




SYSTEMS FLOWCHART SYMBOLS 


9. Manual Input 


10. Generalized I nout/Output Symbol 



11. On-Line Storage Symbol represents the use of 
any kind of on-line backing, store, i.e., disc, 
drum or magnetic tape 



1 2. Off-Line Storage Symbol represents the function 
of storing information off-line, regardless of the 
medium on which the data is recorded. 



13. Document 

14. Punched Card 

15. Deck of Cards 

16. File of Cards: this symbol represents a collection 
of related punched card records. 

17. Punched Tape 

18. Magnetic Tape 










PROGRAM FLOWCHART SYMBOLS 


1. General Operation Symbol : used for any operation 
which creates, alters, transfers or erases data, or any 
other operation for which no specific symbol has 
been defined in the Standard. 

2. Subroutine (Predefined Process) Symbol : used when 
a section of program is considered as a single opera- 
tion for the purpose of this flowchart 


3. Generalized Inout/Output Symbol : used where it is 
desired to stress I/O operations. The symbol is used 
as an alternative to the specific device symbols when: 

— at the time of flowcharting the actual device to be 
used has not been decided, 

— the flowchart is drawn as an example, and is not 
felated to any specific I/O function, 

— local standards specify its use. 

4. Magnetic Tape I/O 


5. Disc I/O 


6. Drum I/O 


7. Document I/O 


8. Punched Card I/O 

9. Punched Paper Tape I/O 






P r ogram flowcharting symbols 
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A 

List of Standard Symbols and Abbreviations 


+ 

Plus or positive 


— 

Minus or negative 


+ 

Plus or minus, positive or negative 


X 

Multiplied by 


Tor/ 

Divided by 


8 

Equals 


* 

Does not equal 


> 

Greater than 


< 

Less than 


> 

Greater than or equal to 


< 

Less than or equal to ' 


c(x) 

Contents of location X 


cf or : 

Compare or compared with 



Used within an operational symbol 
to denote transfer of data 


EOF 

End of file 


E0R 

End of reel 


EOJ 

End of job 

<? 

# 

Reserved for local use 


No. 

Number 



Standard symbols and abbreviations list 
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These rules are: 

1) Decision tables should be drawn on the form shown at the end of 
this section. The layout of the elements of the decision table 
should be: 


CONDITION 

STUB 

• CONDITION 
ENTRY 

ACTION 

STUB 

ACTION 

ENTRY 


The double line separating the stubs from the entries is predrawn. 
The designer should draw his own double line to separate condition 
and action areas of the form. 

2) Only one table should be drawn on each sheet. 

3) Tables must be named at the head of the table. A name of the 
form "TABLE XX" is preferred, but other naming standards may be 
specified locally. Following the name, the words OPEN or CLOSED 
should be written to indicate they type of table. 

4) No decision table should be drawn that has: 

a. more than 4 condition variables, if neither dashes nor an 
ELSE rule are used, or 

b. more than 6 condition variables if dashes and/or an ELSE 
rule are used; 

c. more than 12 decision rules, and 

d. more than 15 action variables. . 




Blanks must not be left In the condition entries. Dashes should 
be used to indicate that the value of a condition does not affect 
a particular action. 

On the condition entries, Y should be used to indicate the truth 
and N the falsity of a condition. 

On the action entries, X should be used to indicate that an action 
is to be followed and I to indicate that it is to be ignored. 
Actions must be written in the order in which they are to be ex- 
ecuted. 

Every effort should be made to combine rules within a table which 
give rise to the same action. It will often be found that the 
value of one condition is immaterial. 

Tables must be drawn up in such a way that all rules are true 
alternatives; rules may be examined in any order but only one 
rule can satisfy a given set of conditions. 

The final action entry for each rule must specify where to go 
next. 

Where the information is available, it can be of considerable 
assistance to the programmer if the expected frequency of 
satisfaction of each rule is indicated on the table. 
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DOCUMENTATION PROCEDURES CURRENTLY IN USE 

The information in this section was selected from material re- 
quested from various companies about their respective documentation 
procedures. The replies received ranged from very brief and indefinite 
requirements to highly specialized and detailed specifications. In 
general, the size of the company and the amount of computer use seemed, 
to affect the volume of documentation required. It should be noted 
that the standards mentioned below are a subset of the documentation 
standards recommended earlier in this report. 

In general, the following items seem to make up some sort of 
accepted "standard." 

1. Abstract - This was required by most of the companies involved. 
The detail of the abstract did vary a little, but the basic 
ideas seemed constant. This generally included items such 

as Program Title, Program Number, Language, Machine Configura- 
tion, I/O Description, etc. 

2. Source Program Decks and Listings - There were some variations 
here. In general, source programs were kept on file and one 
company even suggested maintaining actual card decks if the 
source program was not on tape. In addition to this, general 
setup of Input, JCL, and special information about control of 
the program was also used. 

3. Program Flowcharts in general were required as some part of a 
documented program. The level of these flowcharts varied. One 
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company specified the use of AUTO-FLOW for program logic 
flow. 

4. Systems Flowcharts were used by some of the companies 
involved while others made no mention of them. 

5. Almost all information received made mention of procedures 

for updating documentation for revised jobs. This process varied 
from a detailed set of steps of completely redocumenting 
J the program to merely adding update information to the previous 
documentation. 

6. Details of Data Layout was generally required. This included 
Information about data cards, tapes and other information 
necessary for processing. Keypunch instruction was also requested 
at some levels. 

7. An Operator's Guide was required by a few of the companies 
involved, however, this was not required by all. 

The above list makes up the bulk of the required documentation. The 
detail required obviously varied greatly. Some major companies required 
considerably more than the above mentioned items, while a very small 
company included required only comments in the program listing. 

It was interesting to note that in this latter case, 3 levels of comments 
were specified, depending upon the number of asterisks appended to the 


comment. 
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AN EXAMPLE OF DOCUMENTATION 

One of the better examples of automatically produced program 
documentation which was found was from the USAF. This message switching 
program included in its computer printed output the following: 

(1) A detailed table of contents, which included a list of major 
headings along with subheadings of everything included in this 
listing. Also included was notation used for separating sections, 
sub-sections and further subdivisions via lozenges, periods 

and asterisks. 

(2) Section I of the output was called "1108 STANDARDS". This 
included a list of 23 requirements for running on the particular 
system used. This included information concerning external 

4 

labels, entrance and exit requirements, tags, external drum 
equates, information about standard date, tape codes, etc. 

(3) Section II was called "A CHRONOLOGICAL HISTORY OF COLUMNS 

79 AND 80". This reference to the columns mentioned gave in 
detail information about successive assembly dates and im- 
plementation timetable. The listing included all changes 
made in these assemblies and their dates. These columns 
are used to record program modification levels. This section 
also gives a detailed explanation of what these modifications 
were and why they were made. 
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(4) Section III, "PROGRAM INTERFACE AND RELATED INFORMATION". 

This included instructions to follow in interfaces, overlays, 
flags and related information. Also included in this section 
is information on interrupt analysis. 

(5) Section IV, called "BUFFERS , MAPS, AND TABLES", gave drum 
maps, circuit lists, and several pages of tables. Included 
was polling information, table assignment tables, and 
requirements for polling. All of this information was 
dated. 

(6) Section V, called "PROGRAM DESCRIPTIONS", contained the names 

of and information about all program segments used in this 

run. Each program was listed separately and its contents and 

relation to other programs were given. Information concerning 

# 

on-line or not, where control is received from, specific function 
of program, what all message codes mean, register usage, and 
meanings of switches and table indexes were included. 

Following the above information, which, incidentally, covered 85 
printed pages, came a complete program listing for each program used. 
Comments were used freely throughout. 

It should be emphasized that all of this information (196 pages 
of it!) was printed output. Assembly dates and codes were included 
on each entry. 
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CONCLUDING COMMENTS 

The preceding pages give a summary of what might be desired in some 
standards for systems and program documentation. The automatic production 
of such information is a more challenging problem. Not only do 
standards not exist, but to aggravate matters, documentation software 
now available fails to meet any of the existing standards. Flowcharting 
packages do not follow the "rules" already established and standard 
symbols are not consistently used. 

There is no reason to believe that reasonably good automatic documen- 
tation cannot be developed. Two possible approaches to achieve this goal 
might be: first, if some reasonable documentation standards can be 

established, users should then force software vendors to meet these 
standards. Secondly, if a good automatic documentation system could be 
developed which would satisfy a large portion of the users, its general 
acceptance could make it the standard. The establishment of good standards 
for program documentation will enhance communication at the local project 
level, between different user groups and/or with outside contractors. 
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SUMMARY 

Part I of this proposal discusses the technical approach to the imple- 
mentation of an automatic system for computer program documentation. Section 
1.0 contains a statement of the philosophy. Section 2.0 contains general 
background information and a concise summary of studies that led to the 
system design. Section 3.0 contains detailed design specifications for the 
automatic documentation system. Section 4.0 lists the advantages of the in- 
itial phase of the implementation of the automatic documentation system and 
Section 5.0 covers future expansion. Plan of activity, reports and documents, 
program organization, personnel qualifications, facilities, and program 
schedule are contained in Sections 6 through 11. 



Part I - Technical Proposal 
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1.0 INTRODUCTION 

The Data Processing Center at Texas A&M University is pleased to submit 
this proposal to the National Aeronautics and Space Administration, Goddard 
Space Flight Center in Greenbelt, Maryland. The purpose of the proposed 
project is to implement an automatic system for computer program documentation. 
The system will produce timely, up-to-date documentation at relatively low 
cost. The system will be designed to document any computer language and run 
on any hardware while taking advantage of existing documentation aids. The 
system will be easy to use and will place minimum restrictions on the programmer. 

In computer program development, one of the major problems contributing 
to low programmer productivity is poor communications. The automatic documenta- 
tion system will produce documentation at all phases of system design and 
implementation thereby reducing the communication problem. 

The proposed project will span twelve months. The twelfth month will be 
reserved for installing the automated documentation system at Goddard Space 
Flight Center in Greenbelt, Maryland. The program is divided into five tasks. 

The goal of Task 1 will be to describe in detail all of the programs that will 
be written. Since many of the program requirements are already known, Task 2, 
writing the programs, can begin concurrently with Task 1 and will take about 
eight months. System integration will begin at the end of the third month 
and will be Task 3. Task 3 will include the program checkout phase and 
should cover about seven months. Once the system is in operation at Texas A&M 
University, Task 4, installation of the system at Goddard Space Flight Center in 
Greenbelt, Maryland, will begin. Task 5 commences at the end of the second month 
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when the detailed design is being phased out. This task will be the continuation 
• • 

of the evaluation and planning phase of the automatic documentation project. 

At the end of twelve months, personnel working on Task 5 will have evaluated the 
existing documentation system and proposed a follow-up system for extending 
and adding capability to the automatic documentation system. Documentation of 
the automatic documentation system will be delivered along with the final 
report at the end of the twelfth month. 

The Data Processing Center along with the Computer and Information Sciences 
Division of the Industrial Engineering Department possesses the resources, know- 
how, and Interest to successfully conduct this program. Dr. D. B. Simmons, 
Director of the Data Processing Center at Texas A&M University, Will act as 
principal investigator. He is uniquely qualified to oversee the implementation 
of an automatic system for computer program documentation. The Data Processing 
Center has experience with Implementing and operating computer software systems 
of all sizes and complexity. All necessary hardware and manpower resources will 
be made available to successfully complete the proposed project. Dr. Simmons 
has experience in all levels of computer hardware and software design. While 
an officer in the Signal Corps he evaluated both hardware and software for 
the U.S. Army. As a member of the staff at Bell Telephone Laboratories he 
designed and implemented a design automation system for electronic switching 
systems. One of the main by-products of the system was automated documentation. 
Also while at Bell Telephone Laboratories, Dr. Simmons designed and implemented 
the FLARE automatic flowcharting system. This system reduced the cost of 
producing a flowchart page at Bell Telephone Laboratories from $75 to 50*. At 
present this system is the primary flowcharting system used to document programs 
for electronic switching systems. 
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The Data Processing Center and the Computer and Information Sciences 
Division believe that the tasks and systematic approach presented in this 
proposal are the steps necessary to develop a cost-effective user-oriented 
automatic documentation system. . The proposed system will offer many capabil- 
ities that do not exist in any similar system today. 

2.0 SYSTEM DESIGN 

Under sponsorship of NASA contract NAS5-11911, a detailed survey of all 
existing documentation aids was conducted. Initially all computer-oriented 
literature was searched for anything related to documentation or documentation 
aids. An automated bibliography was used to record all references and key 
words relating to documentation areas. While documentation is one of the 
critical areas in software development, literature describing documentation 
Is sparse. 

A fruitful source of information about documentation aids was literature 
supplied by software houses that sell proprietary systems. Every organization 
that could be found advertising proprietary software aids was sent a letter 
requesting information. The surprising thing from the information received 
about the proprietary systems was the lack of features offered by them. 

Fairly unsophisticated systems are marketed at relatively high prices. No 
organization has implemented a comprehensive system that covers the whole 
spectrum of documentation aids. To use existing systems, users are usually 
required to become expert in numerous special procedures and conventions. 

The proposed system will document programs written in FORTRAN, COBOL, PL/1, 
and Assembly language for the IBM 360 series. It can be easily expanded for 
use with the Uni vac 1108 and the CDC 6600 series computers. The various 
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operating systems .were examined and evaluated for similarity. Working papers 
summarizing the conclusions found in the area of flowcharts, decision tables, 
operating systems, text editors, program editors, documentation standards, 
and computer listing formats were produced. 

Audio techniques are valuable for capturing documentation information. 

An experiment was conducted to determine if audio techniques would be useful 
as an alternative to written text. While it was found that audio techniques 
have special areas of usefulness, no conclusive evidence was found to justify 
replacing other techniques with audio documentation. 

Following the evaluation of existing documentation aids, a comprehensive 
automatic documentation system was designed. Details of the design will be 
presented in the following section. A preliminary design was presented to 
the NASA representatives at Ames, California during August, 1972. Suggestions 
made by NASA were Incorporated into the design. As a result of the August 
meeting, a typical program was chosen to demonstrate the type of documentation 
that would be produced from the automatic documentation system. 

3.0 AUTOMATIC DOCUMENTATION SYSTEM DESCRIPTION 

3.1 SYSTEM FEATURES 

The automatic documentation system will have the following features: 

1. Minimal programmer restrictions - For the programmers who write 
programs In their own unique way, the automated system will be 
able to produce documentation such as detailed, detail -suppressed, 
and global flowcharts, data layouts, overlay descriptions, etc. 
Special cross-reference glossaries can also be produced. Those 
who use the automatic documentation system during initial project 
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phases will automatically obtain extensive documentation. But 
the system will also be designed so that if a program is developed 
outside the system it will be fairly easy to retrofit the program 
Into the system for documentation maintenance. 

2. Eliminate all redundant effort - Documentation produced in an 
early phase of the design or implementation process can be re- 
used later on in the development process. For example, if the 
designer of a programming system describes in detail the function 
of each program subroutine that is produced, the programmer need 
not redescribe the function of the routine when he writes his 
program. The comnents describing the purpose of the subroutine 
will be automatically inserted in the programmer's subroutine. 

3. No operating system modification - No justification can be found 
for modifying an operating system to obtain documentation. Most 
Items of documentation interest can be obtained by scanning 
output produced by operating systems. Information available in 
internal tables of an operating system can be reproduced with 
less effort than it would take to make and maintain modifications 
to the operating system. 

4. Use existing documentation aids - Many man-years of programming 
effort have gone into developing existing documentation aids. A 
number of flowcharters already exist. Text editors containing 
sophisticated algorithms for hyphenation and text layout have been 
developed. Existing documentation aids will be used as modules 

in the comprehensive automated system. 

5.. Interactive/batch system - Users will be able to make use of the 
system by using batch or interactive systems. The data base 
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management system that will be used can accept data using either 
an Interactive or a batch mode. The interactive mode will have 
special features for interrogating the user of the system to 
obtain necessary documentation data. In the batch mode, the 
user will supply necessary information using key word or posi- 
tional parameters. The most user-oriented technique would be 
the Interactive version. 

6. Documentation during development - The documentation data base 
will be constructed from information gathered during all design 
phases. For example, background or design philosophy sections 
generated for system specifications can also be used in final 
documentation. System flowcharts and block diagrams entered 
during system design can be retrieved from the data base to 
produce final documentation. Such things as title of program, 
person responsible for the program, function of subroutine, 
etc. prepared during the design phase would not have to be re- 
created during the program implementation phase. The users would 
supply only that information not available from a previous stage. 

7. Accept any language - The automatic documentation system will 
be language independent. Initially the system will be designed 
to accept FORTRAN, COBOL, PL/1, and Assembly languages. There 
will be no restrictions inherent to the documentation system 
design that will prevent it from being used to document other 
languages. 

8. Operate on any hardware - Initially the system will be designed 
to operate on the IBM 360 with planned expansion to the Univac 
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110$ and the CDC 6600 computer systems. These are the three 
major systems used by NASA. All programs written for the 
automatic documentation system will be written in a machine In- 
dependent language so that the automatic documentation system 
can be easily moved from computer to computer. 

9. Monitor and control project - Features will be designed into 
the system to allow the project manager to monitor the exact 
status of program development and documentation. In addition, 
system access and security will be under his control. 

3.2 INITIAL PHASE 

Work covered by this proposal is termed the initial phase of development 
of the automatic documentation system. The system will be designed to allow 
new features to be added at a later date. During the initial phase either 
FORTRAN or COBOL will be used to write programs that make up the automatic 
documentation system. Initial development will be for a system operational on 
an IBM 360 computer, but software will be easily transportable to the Uni vac 
or CDC systems. The automatic documentation system will document COBOL, FORTRAN 
PL/1, or Assembler language programs. 

The development process can be segmented into many phases. One way of 
subdividing the process is shown in Figure 1 where monitor, specifiers, de- 
signers, programmers, and validators participate in the development of computer 
software. From the very beginning of the program development process, the 
monitor can determine exactly what can be inserted into the data base. The 
specifier writes the Request for Proposal (RFP) or outlines a need for a program 
to be developed. He can enter such Items as title, abstract, system specifica- 
tions, testing criteria, block diagrams, and other elements of the RFP. All of 
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this Information will be stored In the documentation data base. In addition 
to documentation Information, the data base will contain the program source, 
object and job control modules. In other words, the data base will contain 
all Information necessary to describe and develop the program. 

From global specifications, such as the RFP, the designer would draw 
a detailed system flowchart, produce system descriptions, data descriptions, 
program standards, subprogram design, test procedures, and produce a develop- 
ment schedule. All design information will be stored into the data base. 
Documentation aids such as text editors, will minimize the designer's effort 
related to writing and rewriting his design documents. Information such as 
background material and subroutine descriptions will be carried through to 
final documentation. Important design philosophies would be captured at 
early stages and retained. 

Once the design is complete, the programmer can write source code for 
the program and store it in the data base. From source code and information 
In the data base such things as program flowcharts, data layouts, glossaries, 
overlay structures, and extensive cross-reference information can be produced. 
The monitor program will assist the project manager in determining whether a 
programmer is conforming to documentation standards and using good programming 
practices. The monitor can determine the status of the project. Access to 
different modules will be controlled by the program monitor. Documentation 
produced during the development process will aid programmers in understanding 
the operation of other parts of a programming system. This is a major step 
forward in improving communications between programmers and greatly improves 

programmer productivity. 

- » - 
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Once a set of programs has been completed, a validator can verify that 
they work. All Information necessary for the validation process will have been 
established by either the specifier, designer, or programmer. 

. Once the development and Implementation of a program has been completed, 
documentation can be produced for the operation and maintenance phases. The 
automatic documentation system will produce such things as a user, operator, 

•nd maintenance manuals and abstract information for user libraries. 

3.3 SYSTEM STRUCTURE 

The structure of the proposed automatic documentation system is shown 
in Figure 2. Three types of programs will be used in the system. Types 1 
and Z are new programs to be developed. Type 3 are existing programs that 
can be used without change. Type 3 programs make up a major part of the 
Software necessary to Implement the automatic documentation system. New 
programs will not be developed where operational documentation aids are 
available. By doing this, a sophisticated system will be developed at 
a relatively low cost. 

Type 1 programs make up the executive program routines which will con- 
stitute a small part of the overall system. The executive will control 
access to the system, do syntax analysis on the basic commands (both batch and 
interactive), gather usage statistics which are not a function of the data 
base or a single application program and initiate Type 2 programs. Type 1 
functions are shown In Figure 3. The major development effort will be con- 
centrated on Type 2 programs. 

Type 2 programs that will be developed are listed in Figure 4. A general- 
ised editor will take the place of the normal program editor and do preprocessing 
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for a text editor. The reason for using a preprocessor is to facilitate the 
use of many different text editors. The text entered by the user will be 
put into a canonical form which can be transformed for use with any proprie- 
tary text editor that the user may choose. The editor will also have the 
ability to insert text information into a program listing without altering 
the program or data structure. 

A monitor program will be developed which will contain control features 
and produce necessary statistics. The monitor program will check the program 
listing to insure that proper standards and programming practices have been 
used. The documentation data base will be checked and statistics produced 
Identifying the types and amounts of data supplied and items that are missing. 
Exact project status can thus be determined. Documentation error analysis 
Information and access to all data base and program modules will be controlled 
by the monitor. 

Data collection routines construct the data base. Information supplied by 
the programmer will be inserted into the data base by data collection programs 
In a manner transparent to both language and hardware. A standard data base 
management system will be used, greatly reducing the amount of programming 
effort necessary to implement the automatic documentation system. 

The Interactive version of the automatic documentation system will have 
Interrogators for prompting users. In the batch system, a command processor 
will be necessary to perform the same function as the interactive interrogator 
system. 

During the specification, design, programming, and validation process 
appropriate information will be stored in the data base. Documentation re- 
quired during development can then be produced automatically. Data templates 
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will define information to be stored in the data base. To produce a manual, 
a recipe must be defined. This recipe consists of items describing exactly 
what type of 1 information is required in the manual. Recipe building programs 
will specify the structure for final documentation reports such as user, 
operator, or maintenance manuals. Recipe scanner programs will then scan 
these recipes and drive the necessary programs to produce a complete manual. 
Templates for the data base and recipes for final documentation will be under the 
complete control of the manager of a programming project. He can decide ex- 
actly how much documentation and what type of documentation is to be produced. 
When the manager does not want to worry himself with format details of final 
documentation, standard templates of the data base and recipes for the manuals 
will be supplied by the system. Recipe processing programs will scan the 
recipe and drive the programs necessary to produce a complete manual. Drivers 
are called by the recipe scanner that drive application programs. 

Relationships among program modules are shown in Figure 5. For example 
to produce a manual, a recipe for the manual must be defined. Text information 
entered during the specification or design phases may be needed in the user's 
manual to describe philosophy behind program development. These items could 
be specified as part of the recipe. At the point in the manual that the 
system flowchart appears, the flowchart will be produced automatically from 
the job control language. To produce the manual, the recipe will be scanned 
and the appropriate drivers called. To produce the text part of a manual, a 
driver will take text from the data base and drive a text editor. Using this 
technique, a different text editor can be used for each different computer. 

For example, the text editor used for the IBM system might be the TEXT360 or 
ATS system while for the CDC system, the text editor EDIT, under the KRONOS 
operating system may be used. Drivers will be tailored to drive available 
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flowchart systems, to produce flowcharts of programs In various languages. 

The system will be able to produce documentation which is not currently 
available from any existing system. Figure 6 shows levels of documentation 
that can be produced by the system. Most proprietary systems produce documen- 
tation at the local level. They typically produce listings, flowcharts, and 
some type of cross reference. Some, but not all, systems produce detail 
suppressed flowcharts. A few are able to produce functional flowcharts. Data 
layout descriptions usually must be prepared by hand. The proposed system 
will be able to give a two-dimensional detailed data description and a detail 
suppressed description. In the future functional data layouts will be 
automatically produced. 


The local level of documentation is associated with a single compilation 
or assembly. For a program composed of a number of separate modules, global 
flowcharts, and overlay diagrams are useful. The proposed system will be able 
to produce these automatically. Global glossaries, cross-reference tables, and 
data layouts will also be produced. Text will be produced at all levels of 
docwnentation. Global flowcharts will be produced from load modules and 
system flowcharts will be produced from the job control language. System 
block diagrams can be stored in graphic format and reproduced by the documen- 
tation system. All levels of documentation are necessary to understand a 
complex program. Existing commercial systems give only a small fraction of 
the necessary information. 

The Type 3 programs which will be utilized by the system are shown in 
Figure 7. These programs will be utilized without modification. For the IBM 


360 version-, flowcharting systems such as 03/360 Flowchart, QUICKDRAW, or 
AUTOFLOW will be used. A number of text editors are also available. For the 
Initial phase, the TEXT360 text editor will be used. Output from operating 
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systems and compilers will be used as input to programs that draw cross- 
reference tables and flowcharts. Therefore, compilers, linkage editors, and 
loaders are Type 3 programs. Another useful Type 3 program is the TIDY program 
which does such things as renumber FORTRAN statements in ascending order. 

The key to development of the automated documentation system will be 
use of a generalized data base management system. The System 2000 data base 
management system developed by MRI Systems Corporation of Austin, Texas will 
be used. System 2000 is a general purpose data management system with 
features that include a report writer, a user-oriented language providing 
on-line access to non-programmers, a procedural language interface for 
programner use, sequential file processing, two teleprocessing monitors, 
and a multiple thread feature. The system provides archival copies of data 
bases and records an audit trail of changes made to the data base. It is 
capable of reconstructing a data base by applying an audit trail, completely 
or In part, to an archival copy of the data base. The procedural language 
features enable users to manipulate data from COBOL, PL/1, FORTRAN, or 
Assembler language programs. The data base can be accessed from model 33/35 
teletypewriters, IBM 2741 hard copy terminals, and IBM 2260 CRT terminals. 

System 2000 provides a wide range of features to insure data base inte- 
grity. Five levels of security are provided. Security can be provided at 
remote terminals through the use of terminal identification or passwords. 
Password security is available at the system, data base, command, and component 
level. Component level security enables the data base administrator to offer 
four types of access for each component in the data base definition. Thus, 
for each component in the data base there exist sixteen possible access 
combinations. 
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4.0 ADVANTAGES 

Use of the proposed automatic documentation system offers many advantages 
over other techniques for developing programs and producing documentation. The 
system will be user-oriented and will be as easy to operate as existing on- 
line or batch program editors. Programmers who use good programming practices 
when developing software can use all of the system features without extra 
effort. Programmer productivity will be enhanced by improved communication 
during the development process. The modular system will allow new types of 
documentation to be easily added to the system. This is the first system 
that brings together all types of documentation aids into a single user- 
oriented system. It emphasizes documentation on a load module and system 
basis as well as for a single compilation. Documents can be produced that 
are made up of heterogenous output such as text and flowcharts. Managers 
can use the system to control and monitor projects. Program and documenta- 
tion standards can be enforced and taught through the use of the automatic 
documentation system. People who do not use the documentation system during 
program development will be able to use it for post-development documentation. 
Programs developed independently of the automatic documentation system can 
easily be retrofitted into the documentation data base. 

5.0 FUTURE EXPANSION 

As previously mentioned, the system has been designed in a machine in- 
dependent and language independent manner so that it can be easily moved 
from machine to machine and used to document various languages. During the 
initial phase the only graphics will be flowcharts. Graphic capabilities can 
be added to the system at a future time. Any type of two-dimensional drawing 
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osiil d then be placed in a data base. Provision for drawing sophisticated 
data layout descriptions can be added to the system. Documentation of data 
bases and complex data structures can also be automatically drawn. During 
the Initial phase the system will be designed to run on the IBM 360, but it 
can easily be expanded to systems such as the Uni vac 1108 and CDC 6600 that 
have FORTRAN or COBOL compilers. A syntax-directed language extension program 
can be developed to facilitate addition of new languages and output devices. 

Long-term future developments could be to look into the possibility of 
producing all types of documentation from programs that contain unstructured 
comments. A number of program ambiguities can be resolved by simulating 
program execution. Management tools such as PERT diagrams of project status 
can be automatically produced from information found in the documentation data 
base. 

6.0 PLAN OF ACTIVITY 

The implementation of the automatic system for computer program documen- 
tation will be divided into five tasks as shown in Figure 8. The first task 
will be to design each program in detail. The second task will be to write 
the programs. The third task will be to test the programs. The fourth task 
will be to Install the working system at the Goddard Space Flight Center. The 
final task will be to continue the study and evaluation of documentation aids 
to extend the initial phase of the automatic documentation system development. 

6.1 TASK 1 - DETAIL DESIGN 

While the design of the overall system will be completed before the 
projects starts, the detailed design of each routine of the system will take 
place during the initial development process. A design document will be 
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produced as a result of Task 1. Final documentation describing the automatic 
documentation system will be produced by the automatic documentation system. 

6.2 TASK 2 - PROGRAM IMPLEMENTATION 

Task 2 will be the major program implementation phase. Programming will 
fall into four major areas: (1) monitor program, (2) template, recipe, and 

data base builders and recipe scanner, (3) program editor, text editor driver, 
routines for storing FORTRAN, Assembler, COBOL, and PL/1 source programs and 
routines for using a language processor and operating system as input 
( 4 ) drivers to produce local, global, and system documentation. A programmer 
will be assigned to each of these major areas. In addition, a number of 
modules for producing different types of documentation will be produced by 
graduate students as part of their normal course work at no cost to NASA. 

6.3 TASK 3 - PROGRAM CHECKOUT AND TEST 

The automatic documentation system will document the following programs: 

(1) All Type 1 and Type 2 programs of the automatic documentation system, 

(2) A scientific program written in FORTRAN, (3) Administrative programs 
developed by the Texas A&M University Data Processing Center. Checking and 
debugging of the system will be done by the programmers assigned to software 
development. Exercising of the system will be done by graduate assistants 
assigned to the project. Members of the Data Processing Center staff who 
use the automatic documentation system to document their programs will not 
charge their time to the project. Computer costs resulting from documentation 
produced for the Texas A&M University Data Processing Center will not be > 
charged to the project. 
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6.4 TASK 4 - SYSTEM INSTALLATION AT GODDARD 

The system will be Installed at Goddard Space Flight Center after it has 
been extensively checked out at Texas A&M University. Therefore, installation 
and on-site evaluation should take less than a month. Project evaluation will 
be conducted during this period. 

6.5 TASK 5 - STUDY AND EVALUATION 

Study and evaluation of all types of documentation aids w J, *l continue. 

The bibliography on automatic documentation will be updated and maintained. 
Personnel assigned to this task will do an on-going evaluation of the 
automatic documentation system. Future extensions will be designed by this 
group. 

7.0 DATA DOCUMENTATION AND REPORTS 

Texas A&M University will furnish the National Aeronautics and Space 
Administration the following items. 

7.1 PROGRESS REPORT 

A monthly progress report covering progress made during the previous 
month shall be delivered to the Contracting Officer by the tenth of the month 
following the month reported. This report shall state, in concise terms, 

Items such as accomplishments, estimates of funds, commitments during the 
reporting period, plans for the next period, problems and anticipated delays, 
and specific recommendations to facilitate execution of the contract. 

7.2 BRIEFING 

During the first month after contract award, a meeting with the Contract 
Officer and other interested NASA officials in Maryland can be held to discuss 
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the detailed design. At this meeting, Texas A&M will discuss planning for 
project activities. At the end of the fourth month, the detailed design will 
be completed and can be presented to the Technical Officer and other members 
at NASA. If deemed appropriate, another briefing can be given at the end of 
the eighth month. At the end of the project, a briefing can be given to 
describe what has been accomplished and suggest system extensions. 

7.3 DETAILED DESIGN 

At the end of the fourth month the detailed design will be completed and 
a written report will be produced. This design document will be fed into the 
data base as an integral part of the documentation to be produced for the 
project. 

7.4 DELIVERABLE ITEMS 

Source and object programs will be delivered to NASA in Greenbelt, 
Maryland and installed on an IBM 360 computer. Complete documentation of 
the programs will be supplied. All of the documentation will be produced 
using the automatic documentation system. Final documentation produced will 
be an operator's manual, user's manual, and maintenance manual. 

7.5 FINAL PROJECT REPORT 

The contractor shall furnish a draft of the final project report within 
338 days after the effective date of the contract. The government shall be 
allowed seven days to review and return the report with comments and recommen- 
dations to the contractor. The comments and recommendations of the Contract 
Manager shall be taken into consideration in preparing the final report which 
will be submitted to NASA within 21 days after the Contract Officer approval 
of the date. The final project report will completely document all research. 
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recommendations, and results of the efforts during the performance of the 
contract. 


8.0 .PROGRAM ORGANIZATION 

The proposed program will be conducted by members of the professional 
staff of the Data Processing Center and of the Computer and Information 
Sciences Division within the College of Engineering at Texas A&M University. 

Dr., D. B. Simmons, who is Director of the Data Processing Center and a member 
of the Computer and Information Sciences Division faculty will act as principal 
investigator. The Data Processing Center facilities are designed to accomodate 
the teaching, research, and administrative needs of the university. Approxi- 
mately 5056 of the machine time is used by research projects, 20% by academic 
efforts, and 3056 for administrative processing. The Data Processing Center 
employs approximately 80 people, including 33 professionals. Personnel are 
organized into seven groups: System Software, Computer Operations, Computer 


Systems, Administrative Applications, Agricultural /Statistics, Office 
Operations, and Fiscal. The Data Processing Center operates as a separate 
entity with a 72-73 Fiscal Year budget in excess of $1.5 million. 

The Computer and Information Sciences Division is part of the Industrial 
Engineering Department within the College of Engineering at Texas A&M University. 
The Industrial Engineering Department has one of the best programs in the 
country maintaining an effective balance between teaching and research. The 
Computer and Information Sciences Division was established in 1963 and its 
growth is best indicated by its size: 
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In progress. 

(2) 148 graduate students, 112 at the Master level and 36 working 
toward a Ph.D. 
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(3) a new undergraduate program in Computing Science will start in 
the late fall of 1972. 

9.0 PERSONNEL QUALIFICATIONS 

The Data Processing Center along with the Computer and Information 
Sciences Division possess the resources, know-how, and interest to success- 
fully conduct this project. The following people will work directly on the 
project: Dr. D. B. Simmons - one quarter time. Dr. R. W. Elliott - one 

quarter time. Dr. D. Colunga - one quarter time, Ms. S. Arseven - full time, Mr. G. 
H. Kemper - full time, Mr. M. H. Lyle - full time, and Mr. P. Crews - full time. 

Dr. D. B. Simnons, who will serve as principal investigator, has been 
associated with computer field for over 13 years. He started in circuit 
design in 1959 on the early RCA semiconductor computers. He served in the 
Army as Systems Evaluator for computer systems used by the Army. In 1963 he 
joined Bell Telephone Laboratories where he worked in the areas of logic 
design, design automation, automatic program documentation, and automatic 
flowcharting. He designed and developed the FLARE automatic flowcharting 
system. He served as supervisor of the Advanced Programing and Processor 
Technology Group which worked on designs for the 1980* s , programs for im- 
proving design automation systems, high-level electronic switching systems 
(ESS) languages, and automatic flowcharting systems. Since joining Texas A&M 
University in 1970, Dr. Simnons has been involved in teaching, consulting, and 
development of computer operating systems. He has served as principal inves- 
tigator on a project for the development of an operating system for mini -computers 
and as principal investigator on the project to design the automatic documen- 
tation system for NASA. He is currently Director of the Data Processing Center 
and Associate Professor of Computing Science. 
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Dr. Elliott's main area of Interest is Computing Science with specializa- 
tion in computer graphics and information retrieval. Dr. Elliott was Associate 
Director of the Texas Regional Academic Computing Experiment Project sponsored 
by the National Science Foundation. This project had regional computing 
facilities to Tarleton, Prairie View, and Texas Southern Universities from 
Texas A&M University's computer center. Dr. Elliott has experience in computer 
programming, consulting in various computer areas, and in teaching computer 
oriented subjects. 

Dr. Colunga has worked with computers since 1958. From that time, he 
has acquired experience on the following computers: IBM: 650, 1620, 7090, 

7094, 360/65; CDC: 1604, 3600, 6600; Univac 1108. Until last year Dr. Colunga 
was associated with the Theory and Analysis office of the Computation and 
Analysis Division, under the direction of Eugene Brock at NASA/MSC at Houston, 
Texas. While there. Dr. Colunga initiated efforts toward the problem of 
documentation of control -optimization programs available to NASA/MSC users 
through the program share library facilities coordinated by Mr. John Leonard. 
Dr. Colunga is therefore aware of the problems associated with NASA's needs 
for scientific computer program documentation. 

Ms. Susan Arseven has been active in the field of Computer and Information 
Science for more than 8 years. She began her participation in 1964 designing 
and marketing automated systems for libraries and Information centers in New 
York City for IBM Corporation. In 1967 she went to the University of Penn- 
sylvania as the Head of the System Planning Office at the University Library 
where she designed and developed an automated circulation control system, a 
serials catalog, and a book acquisition system and served as advisor to the 
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Director of Libraries on computers and automated techniques. She has made 
major contributions to the project to design the automated documentation 
system for NASA. She is currently a Systems Analyst at the Data Processing 
Center and an Assistant Professor of Computing Science. 

Mr. Kemper and Mr. Lyle have both had extensive experience in systems 
programing and applications programming at Texas A&M University and in 
industry. They are currently both senior members of the Systems Programming 
Group of the Data Processing Center. Mr. Crews, a new addition to the 
programming staff at the Data Processing Center, has a background in scientific 
programming and has developed a mini-computer independent macro processor. 

Besides the above mentioned personnel , this project will use other 
members of the Data Processing Center and Computer aid Information Sciences 
Division faculty on a consulting basis. In addition, there are a number of 
Air Force officers who are working on Master's and Ph.D. degrees in Computing 
Science. They have extensive experience in application areas of computers .. 
within the government and have a first-hand knowledge of documentation problems. 
Any Air Force officer who works on this project in conjunction with a Master's 
or Ph.D. dissertation will charge no time to the contract since- he is already 
being fully funded by the government. 

In addition to the professional staff, three research assistants will 
work in a supporting capacity. Also a half-time secretary will support the 
project. The Data Processing Center and the Computer and Information Sciences 
Division have the expertise in designing, developing, and coordinating soft- 
ware systems to successfully accomplish the goals stated in this proposal. 
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10.0 FACILITIES 

Texas A&M Data Processing Center Is a centralized facility serving the 
computing needs of the entire Texas A&M University campus. It is responsible 
for all of the administrative data processing, educational support, and 
research support on campus. 

The principal computer is an IBM 360/65 with 512 thousand bytes of main 
core storage and 2 million bytes of extended core storage (large core storage). 
This computer is supplemented by an IBM 7090 system used to control experiments 
located in the Cyclotron building. In addition, there is a tape-oriented 
1401 computer that supports the 7090 computer. There is also a PDP mini- 
computer supporting the IBM 360/65 computer. 

The initial system 360 was installed in December, 1967. The present 
configuration includes three card reader punches, four printers, seven mag- 
netic tape drives, 24 2314 disk drives, two IBM 1050 communication terminals, 
four 2740 terminals, five 2741 terminals, and 19 720 Sander Associates terminals. 
The computer also has remote job entry stations at other locations on campus 
such as the library, the Engineering Building, and it has entry stations off 
campus in Houston, San Antonio, Stephenville, and Austin. A Cal Comp Plotter 
and a Gerber automatic drafting machine are available for producing two- 
dimensional graphs. 

Besides the main computer center, there are numerous small computers 
around campus. The Computer and Information Sciences Division has a Data 
General Nova computer with a magnetic tape unit, high speed paper tape reader, 
and an interactive CRT. Also the division has an intelligent terminal connected 
to the main computer. 
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11.0 PROGRAM SCHEDULE 

The program will be divided Into five tasks that will cover a period of 
365 days. The tasks will be broken down as follows: 

TASK ONE - DETAILED DESIGN 
Starting Time - Beginning First Month 
Duration - 4 Months 

Personnel Involved: Dr. D. B. Simmons - 1 man month 

Dr. R. W. Elliott - 3/4 man month 

Dr. D. Colunga - 3/4 man month 

Ms. 5. Arseven - 1 man month 

Graduate Research - 4 man months 
Assistant 

Secretary - 2. man months 


TASK TWO - PROGRAM IMPLEMENTATION 


Starting Time - Beginning First Month 

Duration - 8 Months 

Personnel Involved: Ms. S. Arseven 

Mr. G. H. Kemper 
Mr. M. H. Lyle 
Mr. P. Crews 
Graduate Assistant - 


6 man months 
8 man months 
8 man months 
8 man months 
8 man months 


TASK THREE - PROGRAM CHECKOUT AND TEST 
Starting Time - Beginning of Fourth Month 
Duration - 8 Months 
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